MCP Tools

Overview

Foundry integrates with the Model Context Protocol (MCP) via @nuxtjs/mcp-toolkit. This exposes your documentation to AI agents (ChatGPT, Claude, Cursor, etc.) as structured tools.

Available Tools

list-pages

Lists all documentation pages with titles, descriptions, and paths.

Input: None

Output: Array of { title, path, description, url }

Use case: AI agent needs to explore or search documentation structure.

get-page

Retrieves the full content of a specific documentation page.

Input: { path: string } — The page path (e.g., /docs/getting-started/quickstart)

Output: { title, path, description, content (raw markdown), url }

Use case: AI agent needs the full text of a known page.

Both tools cache results for 1 hour.

Docs Page Header Links

The docs layout includes AI-friendly actions in each page's header dropdown:

• Copy Page — Full raw Markdown to clipboard
• Copy Link — Raw Markdown URL
• GPT — Opens ChatGPT with a prompt to read the page
• Claude — Opens Claude with a prompt to read the page
• Copy MCP Server URL — For adding to AI tool configuration
• Add MCP Server (Cursor) — Cursor deeplink to add the MCP server

nuxt-llms Integration

The foundry example also includes nuxt-llms which generates llms.txt and llms-full.txt files — a simpler alternative to MCP for AI consumption.

Configure sections in nuxt.config.ts:

llms: {
  domain: 'https://yoursite.com',
  title: 'Your Product',
  description: 'What your product does.',
  sections: [
    {
      title: 'Documentation',
      description: 'Full docs',
      contentCollection: 'docs',
    },
  ],
}

See the nuxt-llms documentation for full options.

Enabling MCP

MCP toolkit is included in the layer by default. The tools are registered automatically from server/mcp/tools/. No additional configuration is needed.

To verify, visit /_mcp/tools in development to see registered tools.