Skip to content

mcp-for-builders.mdx

Latest commit

 

History

History
170 lines (131 loc) · 4.35 KB

mcp-for-builders.mdx

File metadata and controls

170 lines (131 loc) · 4.35 KB
title Use Lua with Claude, Cursor & AI IDEs
description Connect Lua's documentation to your AI coding assistant in minutes via MCP

Overview

Lua publishes an MCP (Model Context Protocol) server at https://docs.heylua.ai/mcp. Add it to any MCP-compatible AI tool — Claude Desktop, Cursor, Windsurf, and others — and your assistant gains direct, always-up-to-date access to the full Lua CLI documentation.

Once connected, you can ask questions like "How do I create a scheduled job?" or "Show me the LuaJob API" and get answers grounded in the real docs, not stale training data.

The MCP server is hosted and maintained by Mintlify. It auto-updates whenever the Lua docs are published, so it is always current.

What you get

Two tools become available inside your AI tool the moment it connects:

Tool What it does
search_lua_cli Semantic search across all Lua CLI documentation
get_page_lua_cli Fetch the full content of any specific doc page by path

Your AI assistant will use these automatically when you ask Lua-related questions.

Claude Desktop

On **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` 
On **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

Create the file if it does not exist.
```json { "mcpServers": { "lua-docs": { "type": "http", "url": "https://docs.heylua.ai/mcp" } } } ``` Quit and reopen the app. You should see the Lua tools listed in the MCP tools panel.

Cursor

**Project-level** (only active in this project): ``` .cursor/mcp.json ``` 
**Global** (active in all projects):
```
~/.cursor/mcp.json
```
```json { "mcpServers": { "lua-docs": { "url": "https://docs.heylua.ai/mcp" } } } ``` Open the Command Palette (`Cmd/Ctrl + Shift + P`) and run **Reload Window**, or restart Cursor. The Lua tools will appear in the MCP section of your Cursor settings.

Windsurf

``` ~/.codeium/windsurf/mcp_config.json ``` ```json { "mcpServers": { "lua-docs": { "serverUrl": "https://docs.heylua.ai/mcp" } } } ``` Restart the editor to pick up the new server.

Other tools (mcp-remote fallback)

For AI tools that only support the stdio transport (rather than HTTP), use the mcp-remote bridge:

{
  "mcpServers": {
    "lua-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.heylua.ai/mcp"]
    }
  }
}

This works with any tool that accepts an npx-style stdio MCP server definition.

What to ask

Once connected, your AI assistant can answer questions like:

  • "How do I define a LuaJob with a cron schedule?"
  • "What flags does lua jobs deploy accept?"
  • "Show me the full Jobs API reference."
  • "How do I test a webhook locally?"
  • "What's the difference between a preprocessor and a postprocessor?"

The assistant will call search_lua_cli to find the relevant pages and get_page_lua_cli to pull their full content — so answers come from the actual documentation, not guesswork.

Related

Complete workflow for building Lua agents with Cursor, Windsurf, or GitHub Copilot Connect external MCP servers to your Lua agent All available Lua CLI commands Connect external tools to your agent via MCP