English Français العربية

Maguyva

Official registry Developer tools

Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http maguyva 'https://maguyva.tools/mcp' --header 'Authorization: <Bearer <your Maguyva API key — free at maguyva.ai>. Alternative header: X-API-Key.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "maguyva": {
            "type": "http",
            "url": "https://maguyva.tools/mcp",
            "headers": {
                "Authorization": "<Bearer <your Maguyva API key — free at maguyva.ai>. Alternative header: X-API-Key.>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @maguyva/mcp
  2. Claude Code / Codex
  3. Direct HTTP (preferred for everything else)
  4. This package: the stdio bridge
  5. Install the skill
  6. License

@maguyva/mcp

Maguyva is a code-intelligence MCP server: semantic, structural, graph, and text search across your indexed repositories, so your agent finds exactly what it needs, fast.

Maguyva is a remote streamable-HTTP MCP server at https://maguyva.tools/mcp. Most modern clients connect to it directly — no local process needed. This package is a stdio bridge for the clients that can't.

Pick your path:

Your clientUse
Claude Code or OpenAI CodexThe maguyva/agent-plugins plugin — bundles the connection, the usage skill, and session-start guidance
Supports remote MCP with an Authorization header (Cursor, VS Code, Windsurf, Zed, OpenCode, Gemini CLI, …)Direct HTTP config — see below
stdio-only MCP clientThis package

Whichever path you take, get your API key from the maguyva.ai dashboard, and install the usage skill (see Install the skill) — the skill is what teaches your agent when and how to reach for Maguyva's tools.

Claude Code / Codex

Install the plugin from maguyva/agent-plugins:

/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
export MAGUYVA_API_KEY='<your key>'

The plugin connects over HTTP directly and includes the skill and hooks — nothing else to set up.

Direct HTTP (preferred for everything else)

If your client supports remote MCP servers with a custom Authorization header, connect directly:

{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGUYVA_API_KEY}"
      }
    }
  }
}

Exact config shape varies by client (VS Code uses servers + type: "http", Gemini CLI uses httpUrl, Codex uses TOML, …). The installation docs have a verified copy-pasteable snippet for each client.

This package: the stdio bridge

Only needed when your client speaks stdio but cannot connect to a remote HTTP server directly. It runs locally and forwards between your client's stdio transport and https://maguyva.tools/mcp, reconnecting to the remote without dropping the local pipe.

Requires Node.js. Add to your client's MCP config:

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": ["-y", "@maguyva/mcp"],
      "env": {
        "MAGUYVA_API_KEY": "your-api-key"
      }
    }
  }
}

Options: pass --api-key=KEY instead of the env var, and --server=URL (or MAGUYVA_SERVER_URL) to override the endpoint.

Install the skill

Whatever the transport, install the Maguyva skill so your agent knows how to use the tools well — tool selection, when local grep beats indexed search, and troubleshooting:

curl -fsSL https://maguyva.tools/install-skill.sh | sh -s -- --client <client>

--client accepts claude, opencode, codex, cursor, vscode, gemini, cline, or agents (the generic ~/.agents/skills path). The skill is authored to the open Agent Skills standard and lives in maguyva/agent-plugins. Claude Code and Codex plugin users already have it — the plugin bundles it.

License

MIT

Frequently asked questions

What is Maguyva?

Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.

How do I install Maguyva?

It runs as a remote server. In Claude Code: claude mcp add --transport http maguyva 'https://maguyva.tools/mcp' --header 'Authorization: <Bearer <your Maguyva API key — free at maguyva.ai>. Alternative header: X-API-Key.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Maguyva need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is Maguyva open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Maguyva?

It is published by Maguyva. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.