{
  "markdown": "# topolift-mcp\n\nMCP server exposing **TopoLift's atom-grounded negotiation reasoning** to any MCP-capable agent — Claude Code, Cursor, OpenAI Agents SDK, etc.\n\n> Listed on the [official MCP Registry](https://registry.modelcontextprotocol.io/) as `io.github.TopoLift/topolift-mcp`.\n>\n> mcp-name: io.github.TopoLift/topolift-mcp\n\n## What you get\n\nTwo tools:\n\n- **`topolift_dialect`** — fetches TopoLift's published vocabulary (regimes, canonical strategies, signal keys, citation grammar). Call this once at session start; no auth required.\n- **`topolift_negotiate`** — sends a negotiation context to TopoLift's reasoning engine and returns a **bilingual response**:\n  - A typed `topology` slot (`regime`, `load_bearing_strategies[]`, `bridge_pivots[]`, `topology_signals{}`) drawn from a closed vocabulary\n  - Prose fields with inline `[Cluster_X#strategy1,strategy2]` citation tokens anchoring every claim to the cluster + load-bearing atoms that drove it\n\nAtoms stay on the TopoLift server. What travels is the *grammar* of the dialect — the vocabulary your agent uses to read structural reasoning.\n\n## Install\n\n```bash\npip install topolift-mcp\n```\n\nSet your API key (get one at <https://topolift.ai>):\n\n```bash\nexport TOPOLIFT_API_KEY=tl-...\n```\n\n### Claude Code\n\n```bash\nclaude mcp add topolift-negotiation -- topolift-mcp\n```\n\n…or, with the API key inline:\n\n```bash\nclaude mcp add topolift-negotiation -e TOPOLIFT_API_KEY=tl-... -- topolift-mcp\n```\n\n### Cursor / Continue / other MCP clients\n\nAdd to your MCP config (`~/.cursor/mcp.json` or equivalent):\n\n```json\n{\n  \"mcpServers\": {\n    \"topolift-negotiation\": {\n      \"command\": \"topolift-mcp\",\n      \"env\": {\n        \"TOPOLIFT_API_KEY\": \"tl-...\"\n      }\n    }\n  }\n}\n```\n\n### Running directly (no install)\n\n```bash\nTOPOLIFT_API_KEY=tl-... python -m topolift_mcp.server\n```\n\n## Configuration\n\nEnvironment variables:\n\n| Var | Default | Purpose |\n|---|---|---|\n| `TOPOLIFT_API_KEY` | *(required for negotiate)* | Bearer key; get one at <https://topolift.ai> |\n| `TOPOLIFT_API_URL` | `https://api.topolift.ai` | API base URL |\n| `TOPOLIFT_TIMEOUT` | `600` | Negotiate-call timeout in seconds |\n| `TOPOLIFT_LOG_LEVEL` | `INFO` | Python logging level |\n\nThe dialect tool works without `TOPOLIFT_API_KEY` — only `topolift_negotiate` requires it.\n\n## Pricing\n\n- **Bearer key** (this MCP server's path): one-time / monthly plans starting at $50. See <https://topolift.ai>.\n- **x402 micropayment**: agents can pay $0.10 USDC per call directly against `https://api.topolift.ai/v1/negotiate` with no API key — see the API's 402 challenge for details.\n\n## How it works\n\n1. Your agent calls `topolift_dialect` once and learns the vocabulary.\n2. Your agent calls `topolift_negotiate` with a scenario.\n3. TopoLift retrieves the most relevant atom clusters from its server-side topology, runs a Mistral-Small-4-119B reasoning pass with a closed-vocabulary prompt, and returns the bilingual response.\n4. Your agent parses `topology` for machine-readable structure and reads the prose fields with citation-traceable evidence.\n\nThe atoms — the structural primitives — never leave TopoLift's servers. The dialect — the names and the grammar — is published openly so any agent can read structural reasoning fluently.\n\n## License\n\nMIT\n",
  "bytes": 3267,
  "sha": "d3f8e99f114ea213bed132016acf81ee89840754626f13f50ab46e88098501c9",
  "repo_slug": "topolift/topolift-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_topolift_topolift_mcp_2acfcae4/readme"
}