usamaasfar/supersurf

Supersurf MCP Server

A documentation answer engine MCP server for AI coding agents. Supersurf provides intelligent search and fetch capabilities for coding documentation, powered by AI to give you precise answers from official docs.

Functions

• fetch - Fetches URLs and converts HTML to clean text. If query is empty, returns raw content. If query provided, uses AI to analyze content and answer questions.
• search - Searches the web using AI search engines (Exa/Jina/Tavily), then uses AI to analyze results and provide intelligent answers.

Providers

Search Providers

Supersurf supports multiple search providers. Set one of the following API keys:

• Exa: Set EXA_API_KEY
• Jina: Set JINA_API_KEY
• Tavily: Set TAVILY_API_KEY

LLM Providers

Supersurf supports multiple LLM providers. Set one of the following API keys:

• OpenAI: Set OPENAI_API_KEY (default model: gpt-5-2025-08-07)
• Anthropic: Set ANTHROPIC_API_KEY (default model: claude-sonnet-4-20250514)
• Groq: Set GROQ_API_KEY (default model: moonshotai/kimi-k2-instruct)
• Google: Set GOOGLE_API_KEY (default model: gemini-2.5-pro)
• Mistral: Set MISTRAL_API_KEY (default model: mistral-medium-2508)
• XAI: Set XAI_API_KEY (default model: grok-4-0709)

Note: The system automatically detects which API keys are available and uses the first one found. You can override the default model by setting the MODEL environment variable.

Installation

Claude Desktop

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "supersurf": {
      "command": "npx",
      "args": ["-y", "@supersurf/mcp"],
      "env": {
        "EXA_API_KEY": "your-exa-api-key",
        "GROQ_API_KEY": "your-groq-api-key"
      }
    }
  }
}

Claude Code MCP

Add the MCP server using the Claude CLI:

claude mcp add supersurf --env EXA_API_KEY=your-exa-key --env GROQ_API_KEY=your-groq-key -- npx -y @supersurf/mcp

Development

Local Development

# Clone the repository
git clone https://github.com/usamaasfar/supersurf.git
cd supersurf

# Install dependencies
npm install

# Build the project
npm run build

# Run in HTTP mode (development)
node dist/index.js

# Run in STDIO mode (production/MCP)
node dist/index.js --stdio

License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.