Maguyva

ai.maguyvaPublished by maguyva.aiv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Maguyva gives coding agents semantic, AST, graph, and full-text search across indexed repositories in over 279 languages.

What you can do
Maguyva is a remote code-intelligence MCP server that exposes semantic, structural, graph, and text search over repositories you have indexed. It is meant to help an agent locate relevant code quickly instead of relying on plain text matching. The README also describes a companion skill that guides tool selection and when local grep is preferable.
When to use it
Worth adding when a coding assistant needs to navigate large or multi-language codebases and plain text search is too slow or imprecise. It is most useful for clients that can connect to a remote MCP server over HTTP.
Requirements
A remote streamable-HTTP endpoint at maguyva.tools, reachable over the network. An API key from the maguyva.ai dashboard, supplied as an Authorization bearer header or the X-API-Key header. The optional stdio bridge package requires Node.js and the MAGUYVA_API_KEY environment variable.
Before you install
The server requires an API key sent as an Authorization bearer header or X-API-Key header; treat it as a secret. Repository content is sent to a third-party remote service for indexing and search. The README suggests installing a skill via a shell script fetched from the provider's site, which runs code on your machine.

Installation

In SourceWeft

  1. Open Maguyva in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.maguyva%2Fmaguyva/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

@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@maguyvaexport 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:

json
{  "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:

json
{  "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

Source: README.md at commit 6e20e49

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts