Search Documentation

Search guides, functions, classes, interfaces, and more

Cursor setup for miniapps

Use MobyApps docs MCP and a project Cursor rule so agents can scaffold, theme, and call SDK APIs correctly.

MCP — moby-docs (remote)

Add to ~/.cursor/mcp.json (works from any repo):

{
  "mcpServers": {
    "moby-docs": {
      "url": "https://docs.mobyapps.dev/api/mcp"
    }
  }
}

Restart Cursor. The server exposes:

ToolUse for
list_guidesMiniapp setup, theming, Turbo monorepo guides
get_guideFull guide content by slug
search_api / get_api_itemSDK, bridge, omapi API lookup

Example prompts:

  • "Use get_guide for create-miniapp and scaffold a new miniapp"
  • "How do I use pages_api.show?"

MCP — shadcn (optional)

For adding shadcn primitives and @mobyapps/app-kit updates:

{
  "mcpServers": {
    "shadcn": {
      "command": "npx",
      "args": ["shadcn@latest", "mcp"]
    }
  }
}

Project Cursor rule

Copy .cursor/rules/mobyapps-miniapp.mdc from the create-miniapp scaffold, or from the sdk repo template at docs/templates/cursor/external-miniapp.mdc.

The rule tells agents to:

  • Resolve @mobyapps/* from npm.mobyapps.dev
  • Use local @/components/ui/app/* for app chrome (app-kit)
  • Theme via styles/miniapp-theme.css / miniapp-dark.css
  • Call moby-docs MCP for SDK API questions

Local MCP (sdk monorepo maintainers only)

Prefer the remote URL above. A local stdio server exists for sdk maintainers — see apps/moby-docs/MCP_SETUP.md in that repo.

Next steps