Code Fundi MCP server

Code Fundi The Codebase Map for AI Agents, Teams and Applications.

Code-Fundi MCP Server

A production-grade Model Context Protocol (MCP) server for the Code-Fundi API: a codebase map and blast-radius engine for AI coding agents. Enables any MCP-compatible AI assistant (Claude, Claude Code, Cursor, Windsurf, VS Code Copilot, and more) to search, research, index, and scan code repositories through natural language, and see what a change breaks before it ships.

Built with FastMCP (TypeScript) and Zod for schema validation.

Getting started for AI agents

If you are an AI agent (or configuring one) and no CODEFUNDIAPIKEY is set, you must self-authenticate before using search, repos, chat, or other authenticated tools. The auth tools (code-fundi-auth-*) work without a pre-existing key.

Which path to use

Zero-config MCP setup (no API key)

You can start the MCP server without CODEFUNDIAPIKEY and authenticate at runtime:

{
  "mcpServers": {
    "code-fundi": {
      "command": "npx",
      "args": ["-y", "@codefundi/code-fundi-mcp"]
    }
  }
}

Self-authenticate with OTP (recommended)

Code-Fundi uses Supabase-backed auth (POST /v2/auth/authenticate, /v2/auth/verify, /v2/auth/resend). OTP emails contain a 6-digit code — magic links are not supported on this path.

1. Ask the human user for their email address.
2. Call code-fundi-auth-authenticate with:

• auth_mode: "otp"
• email: the user's email
• shouldcreateuser: true for a new account, false for a returning user

1. Tell the user to check their inbox for a 6-digit code. The API may return verificationrequired: true and apikey.keystate: "agentpending" until verification completes.
2. Ask the user for the 6-digit OTP (human-in-the-loop — you cannot guess or bypass this step).
3. Call code-fundi-auth-verify with the same email and the token (6 digits).
4. On success, the MCP server automatically configures the API key in memory for all subsequent tool calls in this session.

If the code expired or was not received, call code-fundi-auth-resend with the same email, then repeat step 5.

Example dialogue:

Agent: What email should I use to sign in to Code-Fundi?
User:  dev@example.com
Agent: [calls code-fundi-auth-authenticate] I've sent a 6-digit code to dev@example.com. Please paste it here.
User:  482913
Agent: [calls code-fundi-auth-verify] You're signed in. I can now search and index your repositories.

Password sign-in (alternative)

Shortened. The full README is on GitHub.