CodeFundi

{ "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 a6-digit code— magic links are not supported on this path.
- Ask the human user for their email address.
- Callcode-fundi-auth-authenticatewith:

- auth_mode:"otp"
- email: the user's email
- should_create_user:truefor anewaccount,falsefor areturninguser

If the code expired or was not received, callcode-fundi-auth-resendwith the sameemail, then repeat step 5.

For existing accounts with a password, callcode-fundi-auth-authenticatewithauth_mode: "password", the user'semail,should_create_user: false, and thepasswordparameter. The MCP client sends the password only in theX-CodeFundi-Auth-Passwordheader (never in the JSON body). Production requires HTTPS. Returning users may receive an active API key immediately without a separate verify step.

- The API key is heldin memoryfor the lifetime of the MCP server process. It isnotpersisted across IDE or MCP restarts.
- Recommend the user add the key to their MCP config asCODEFUNDI_API_KEYso future sessions start authenticated.
- A FREE-tier account and API key are created automatically on first signup.

Every tool below is backed by the same codebase map: structural dependencies, call graph, and blast radius, indexed once and queried in milliseconds.

Install the package (includes a pre-builtdist/). Thecode-fundi-mcpbinary is on yourPATHwhen installed globally, or available vianpxwithout cloning the repo:

npm install -g @codefundi/code-fundi-mcp

git clone https://github.com/Code-Fundi/code-fundi-mcp.git cd code-fundi-mcp npm install npm run build

Option A — API key (fastest):set your key as an environment variable:

export CODEFUNDI_API_KEY=your_api_key_here

Option B — no API key:skip the env var and let the agent self-authenticate at runtime. SeeGetting started for AI agents.

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

After a global install (npm i -g @codefundi/code-fundi-mcp), point MCP at the published binary (no path todist/index.jsrequired):

{ "mcpServers": { "code-fundi": { "command": "@codefundi/code-fundi-mcp", "env": { "CODEFUNDI_API_KEY": "your_api_key_here" } } } }

If the binary is not on yourPATH, usenpx(downloads or uses the local package and runs the same entrypoint):

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

Same pattern as Claude:commandplus optionalargsonly, no manual path to the repo:

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

When developinginside this repo, you can runnpm run devornpx tsx src/index.tswithout building first.

npm run dev # Run with tsx (no build needed) npx fastmcp inspect src/index.ts # Open MCP Inspector UI npx fastmcp dev src/index.ts # Test with MCP CLI

Covers the Code-FundiV2API for codebase mapping and blast-radius analysis: search (including search-with-chat / research), repositories (list, index, status, readme, public catalog), repository intelligence (map, blueprint, radius), files, history, statistics, API keys, authentication, plusFundi chat(POST /v1/fundi/chat) and the V2 model catalog / limits (GET /v2/models,GET /v2/models/limits).

Two modes:pre-configured API key(CODEFUNDI_API_KEYin MCP config) oragent-driven OTP/password authat runtime. Full step-by-step instructions, tool names, and error handling are inGetting started for AI agentsat the top of this README.