{
  "markdown": "# @maguyva/mcp\n\n[Maguyva](https://maguyva.ai) 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.\n\nMaguyva 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.\n\n**Pick your path:**\n\n| Your client | Use |\n|---|---|\n| Claude Code or OpenAI Codex | The [maguyva/agent-plugins](https://github.com/maguyva/agent-plugins) plugin — bundles the connection, the usage skill, and session-start guidance |\n| Supports remote MCP with an `Authorization` header (Cursor, VS Code, Windsurf, Zed, OpenCode, Gemini CLI, …) | Direct HTTP config — see below |\n| stdio-only MCP client | This package |\n\nWhichever path you take, get your API key from the [maguyva.ai](https://maguyva.ai) dashboard, and install the usage skill (see [Install the skill](#install-the-skill)) — the skill is what teaches your agent when and how to reach for Maguyva's tools.\n\n## Claude Code / Codex\n\nInstall the plugin from [maguyva/agent-plugins](https://github.com/maguyva/agent-plugins):\n\n```\n/plugin marketplace add maguyva/agent-plugins\n/plugin install maguyva@maguyva\nexport MAGUYVA_API_KEY='<your key>'\n```\n\nThe plugin connects over HTTP directly and includes the skill and hooks — nothing else to set up.\n\n## Direct HTTP (preferred for everything else)\n\nIf your client supports remote MCP servers with a custom `Authorization` header, connect directly:\n\n```json\n{\n  \"mcpServers\": {\n    \"maguyva\": {\n      \"url\": \"https://maguyva.tools/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${MAGUYVA_API_KEY}\"\n      }\n    }\n  }\n}\n```\n\nExact config shape varies by client (VS Code uses `servers` + `type: \"http\"`, Gemini CLI uses `httpUrl`, Codex uses TOML, …). The [installation docs](https://maguyva.ai/docs/installation) have a verified copy-pasteable snippet for each client.\n\n## This package: the stdio bridge\n\nOnly 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.\n\nRequires Node.js. Add to your client's MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"maguyva\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@maguyva/mcp\"],\n      \"env\": {\n        \"MAGUYVA_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\nOptions: pass `--api-key=KEY` instead of the env var, and `--server=URL` (or `MAGUYVA_SERVER_URL`) to override the endpoint.\n\n## Install the skill\n\nWhatever 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:\n\n```\ncurl -fsSL https://maguyva.tools/install-skill.sh | sh -s -- --client <client>\n```\n\n`--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](https://agentskills.io) and lives in [maguyva/agent-plugins](https://github.com/maguyva/agent-plugins). Claude Code and Codex plugin users already have it — the plugin bundles it.\n\n## License\n\nMIT\n",
  "bytes": 3349,
  "sha": "35af336985ed7de99e36ce39577f0a8c613fa55cc37011d237035f6f48f26a2c",
  "repo_slug": "maguyva/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_maguyva_maguyva_b3a61198/readme"
}