{
  "markdown": "# within-mcp\n\n> Public plugin/extension distribution for the Within MCP server.\n\n📚 **Developer documentation:** <https://developers.within.ai/>\n\n`within-mcp` packages [Within](https://www.within.ai/) as an installable\nplugin for AI assistant clients that speak the [Model Context Protocol](https://modelcontextprotocol.io/).\nOnce installed, the plugin lets your assistant query your organization's processes,\nexplore the Process Index knowledge graph, and ground answers in how your business\nactually runs — not generic guesses.\n\nThis repository is the canonical public surface for two install paths:\n\n- **Claude Code / Claude** — Anthropic's plugin ecosystem.\n- **ChatGPT / Codex** — OpenAI's app ecosystem.\n- **Gemini CLI** — Google's CLI extension ecosystem.\n\n\n## What it does\n\nThe plugin connects your AI assistant to the Within MCP server at\n`https://api.within.ai/mcp`. Tools the assistant gets access to\ninclude `search`, `fetch`, process-hierarchy navigation, evidence retrieval, and\nContext Graph traversal. The full skill prompt lives at\n[`skills/within-process-context-graph/SKILL.md`](./skills/within-process-context-graph/SKILL.md).\n\n## Install - Claude.ai\n\nCustomize -> Connectors -> Search -> Within -> Connect\n\n> (NOTE: your organization might have to approve this connector, and you should be added as a user into Within for this to work)\n\n## Install - ChatGPT\n\nApps -> Search -> Within -> Connect\n\n> (NOTE: your organization might have to approve this app, and you should be added as a user into Within for this to work)\n\n## Install — Claude Code\n\nFrom a Claude session, run these two commands one after the other.\n\n**1. First**, install the marketplace:\n\n```text\n/plugin marketplace add Within-AI/within-mcp\n```\n\n**2. Next**, install the plugin:\n\n```text\n/plugin install within@within\n```\n\n## Install — Codex\n\nCodex splits this into two steps. First, from your **shell**, register the\nWithin marketplace with Codex:\n\n```bash\ncodex plugin marketplace add Within-AI/within-mcp\n```\n\nThen, from a **Codex session**, run:\n\n```text\n/plugins\n```\n\nSearch for **Within** and install the plugin.\n\nThe first request that hits a Within tool will prompt you to sign in.\n\n## Install — Gemini CLI\n\n```bash\ngemini extensions install https://github.com/Within-AI/within-mcp\n```\n\nTo login:\n```\n/mcp auth within\n```\n\n## Authentication\nYou will need to be a Within customer to access this app.\n\nThe first time the plugin connects, your AI client will prompt you to sign in\nto Within. the MCP will use whatever authentication is configured by your organization for Within.\n\n> **Fallback:** If your client does not yet support MCP OAuth, you can issue\n> a personal API key from your Within workspace settings and configure your\n> client to send it as a `Bearer` token. Contact\n> [hello@within.ai](mailto:hello@within.ai) for guidance.\n\n## Repository layout\n\n| Path | What it is |\n|---|---|\n| `within_mcp/` | Python package: metadata + builders + CLI for regenerating manifests |\n| `.claude-plugin/plugin.json` | Claude Code plugin manifest (generated) |\n| `.claude-plugin/marketplace.json` | Claude Code marketplace catalog (generated) |\n| `.codex-plugin/plugin.json` | Codex plugin manifest (generated) |\n| `.agents/plugins/marketplace.json` | Codex marketplace catalog (generated) |\n| `.mcp.json` | Shared MCP server config (HTTP transport; used by Claude Code and Codex) |\n| `gemini-extension.json` | Gemini CLI extension manifest (generated) |\n| `skills/within-process-context-graph/SKILL.md` | The Within skill prompt |\n| `tests/test_packaging.py` | Manifest invariants + drift checks |\n| `LICENSE` | Apache-2.0 (covers this shim only — see `NOTICE`) |\n| `NOTICE` | Trademark + commercial-service notice |\n\n## For Within Team - Regenerating Manifests\n\n```bash\npip install -e \".[dev]\"\npython -m within_mcp --write     # regenerates the public manifests\npython -m within_mcp --check     # CI-side drift check\npytest -v\n```\n\nThe metadata that drives every manifest lives in\n[`within_mcp/metadata.py`](./within_mcp/metadata.py). Edit there, then re-run\n`--write` and commit the result.\n\n## License\n\nThis plugin shim is released under the [Apache License 2.0](./LICENSE). The\nWithin service it connects to is a commercial service governed by\nWithin's Terms of Service. See [`NOTICE`](./NOTICE) for details.\n\n## Links\n\n- Within: <https://www.within.ai/>\n- Privacy Policy: <https://www.within.ai/product-privacy-policy>\n- Terms of Service: <https://www.within.ai/terms-of-service-2025>\n- Issues / contact: <mailto:hello@within.ai>\n",
  "bytes": 4527,
  "sha": "d61b8f0f967c05d7a596d9c541a47e14a023e2e54ea4f0ffcf1c9606d524d35c",
  "repo_slug": "within-ai/within-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_within_ai_within_mcp_klarity_a4055fdc/readme"
}