santuri-mcp-server

santuri-mcp-server

MCP server for Santuri — official llms.txt documentation for AI assistants.

Overview

This server implements the Model Context Protocol to give AI assistants like Claude, Cursor, and Windsurf access to up-to-date technical documentation. Search across curated documentation sources including React, Next.js, Supabase, Tailwind, and more.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "santuri": {
      "command": "npx",
      "args": ["-y", "santuri-mcp-server"]
    }
  }
}

Claude Code

claude mcp add santuri -- npx -y santuri-mcp-server

Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "santuri": {
      "command": "npx",
      "args": ["-y", "santuri-mcp-server"]
    }
  }
}

Configuration

The server works out of the box with anonymous access (100 searches/day). For higher limits, configure an API key.

Environment Variables

Variable	Required	Description
SANTURI_API_KEY	No	API key for authenticated access (higher rate limits)
SANTURI_PROJECT_ID	No	Limit searches to sources in a specific project
SANTURI_SOURCES	No	Comma-separated list of source slugs to search (e.g., nextjs,react,supabase)
SANTURI_API_URL	No	Custom API endpoint (defaults to https://santuri.io)
SANTURI_STACK_ID	No	Deprecated: Use SANTURI_PROJECT_ID instead

Priority: When both are set, SANTURI_PROJECT_ID takes precedence over SANTURI_SOURCES.

With API Key

{
  "mcpServers": {
    "santuri": {
      "command": "npx",
      "args": ["-y", "santuri-mcp-server"],
      "env": {
        "SANTURI_API_KEY": "your-api-key"
      }
    }
  }
}

Get your API key at santuri.io/api-keys.

With Sources Filter

Limit searches to specific documentation sources without a project:

{
  "mcpServers": {
    "santuri": {
      "command": "npx",
      "args": ["-y", "santuri-mcp-server"],
      "env": {
        "SANTURI_SOURCES": "nextjs,react,tailwindcss"
      }
    }
  }
}

Available Tools

search_documentation

Search across all configured documentation sources using semantic search.

Parameters:

• query (required): Natural language search query
• limit (optional): Maximum results (1-50, default: 10)

Example:

Search for: "how to set up authentication in Next.js with Supabase"

list_sources

List all available documentation sources.

Parameters:

• category (optional): Filter by category (e.g., "AI/ML", "Platform", "Database")

Rate Limits

Access	Daily Searches
Anonymous	100
Free (with API key)	1,000

Limits reset at midnight UTC.

Development

# Clone the repository
git clone https://github.com/sonofakel/santuri-mcp-server.git
cd santuri-mcp-server

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Run tests
pnpm test

# Build
pnpm build

Security

This package:

• Never stores or logs API keys
• Uses HTTPS for all API communication
• Validates all inputs with Zod schemas
• Has minimal dependencies (2 production deps)

For security concerns, see SECURITY.md or email [e-mail].

License

MIT - see LICENSE

Links

• Santuri Website
• Documentation
• GitHub Issues
• Model Context Protocol