Factory MCP Server

MCP server exposing Factory.ai CLI documentation search and markdown tools.

Features

Tools

• searchFactoryDocs – Search the Factory.ai CLI documentation sitemap.
• fetchFactoryDocMarkdown – Fetch markdown content for a specific Factory.ai documentation page.

Functionality

• Caches sitemap entries with configurable TTL and retries.
• Scores search results with recency and title relevance.
• Validates requests with Zod schemas to keep tool usage predictable.

Development

Install dependencies:

npm install

Build compiled outputs:

npm run build

Run the test suite:

npm test

Type-check the codebase:

npm run typecheck

Installation

Factory CLI Integration

Use /mcp add to register the server (see https://docs.factory.ai/factory-cli/configuration/mcp.md):

/mcp add factory-cli-docs "npx -y factory-mcp"

Include environment variables when needed:

/mcp add factory-cli-docs "npx -y factory-mcp" -e FACTORY_DOCS_CACHE_TTL_MS=60000 -e FACTORY_DOCS_LOG_LEVEL=debug