Model Context Protocol (MCP)

SomeScript Docs provides a built-in Model Context Protocol (MCP) server. MCP allows AI coding assistants (such as Cursor, Antigravity, Claude Desktop, and VS Code) to perform live searches, discover pages, and fetch documentation content directly inside your development workspace.

MCP Server Endpoint

The MCP server is available natively at /mcp:

/mcp

When connecting from your editor, use your documentation domain URL (e.g. http://localhost:3003/mcp during local development).

Editor & Agent Setup

Cursor

Add the MCP server to .cursor/mcp.json or your Cursor settings:

{
  "mcpServers": {
    "somescript-docs": {
      "url": "http://localhost:3003/mcp"
    }
  }
}

Antigravity / AGY CLI

Add the server to your agy environment:

agy mcp add somescript-docs http://localhost:3003/mcp

Claude Desktop

Add the server to claude_desktop_config.json:

{
  "mcpServers": {
    "somescript-docs": {
      "url": "http://localhost:3003/mcp"
    }
  }
}

Available MCP Tools

Once connected, your AI assistant receives the following tools automatically:

1. list-pages: Discovers all available documentation sections, pages, and URLs.
2. get-page: Fetches the exact Markdown content and metadata for any specific page.

Server Configuration

The MCP server is configured in nuxt.config.ts:

export default defineNuxtConfig({
  docus: {
    assistant: {
      mcpServer: '/mcp',
    },
  },
  mcp: {
    enabled: true,
  },
})