Summary
Connects Claude, Cursor, or any MCP client to TopoLift's atom-grounded negotiation reasoning engine via two tools: topolift_dialect fetches the published vocabulary of regimes, strategies, and citation grammar once per session, and topolift_negotiate sends a scenario and returns both a typed topology slot with machine-readable structures and prose with inline citation tokens linking every claim back to the atom clusters that produced it. The atoms stay server-side; what you get is the dialect to read structural reasoning. Requires a bearer key from topolift.ai for negotiation calls, though the vocabulary tool works without auth. Useful when you need negotiation or conflict analysis with traceable reasoning anchored to a closed vocabulary rather than ungrounded LLM output.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
2 tools
topolift_dialectFetch TopoLift's negotiation dialect — the closed vocabulary of regimes, canonical strategies, topology signal keys, metric roles, and the inline citation format used in negotiate responses. Call this once at the start of a session to learn what values to expect in the typed `...
Fetch TopoLift's negotiation dialect — the closed vocabulary of regimes, canonical strategies, topology signal keys, metric roles, and the inline citation format used in negotiate responses. Call this once at the start of a session to learn what values to expect in the typed `...
No parameter schema in public metadata yet.
topolift_negotiateGet atom-grounded structural reasoning for a negotiation scenario. The response is BILINGUAL: - `topology` (object) is the typed dialect view: regime, load_bearing_strategies[], bridge_pivots[], topology_signals{}. Every value is drawn from the closed vocabulary — fetch the di...15 params
Get atom-grounded structural reasoning for a negotiation scenario. The response is BILINGUAL: - `topology` (object) is the typed dialect view: regime, load_bearing_strategies[], bridge_pivots[], topology_signals{}. Every value is drawn from the closed vocabulary — fetch the di...
Parameters* required
goalsstringphasestringdefault: unknown
urgencystringdefault: medium
questionvaluescenariostringconstraintsvalueaspiration_pricevaluereservation_pricevalueconversation_historyvaluerelationship_prioritystringdefault: short_term
current_offer_on_tablevaluecounterparty_is_ai_agentvaluecounterparty_behavior_signalsvaluecounterparty_known_constraintsvaluecounterparty_known_preferencesvaluetopolift-mcp
MCP server exposing TopoLift's atom-grounded negotiation reasoning to any MCP-capable agent — Claude Code, Cursor, OpenAI Agents SDK, etc.
Listed on the official MCP Registry as
io.github.TopoLift/topolift-mcp.mcp-name: io.github.TopoLift/topolift-mcp
What you get
Two tools:
topolift_dialect— fetches TopoLift's published vocabulary (regimes, canonical strategies, signal keys, citation grammar). Call this once at session start; no auth required.topolift_negotiate— sends a negotiation context to TopoLift's reasoning engine and returns a bilingual response:- A typed
topologyslot (regime,load_bearing_strategies[],bridge_pivots[],topology_signals{}) drawn from a closed vocabulary - Prose fields with inline
[Cluster_X#strategy1,strategy2]citation tokens anchoring every claim to the cluster + load-bearing atoms that drove it
- A typed
Atoms stay on the TopoLift server. What travels is the grammar of the dialect — the vocabulary your agent uses to read structural reasoning.
Install
pip install topolift-mcp
Set your API key (get one at https://topolift.ai):
export TOPOLIFT_API_KEY=tl-...
Claude Code
claude mcp add topolift-negotiation -- topolift-mcp
…or, with the API key inline:
claude mcp add topolift-negotiation -e TOPOLIFT_API_KEY=tl-... -- topolift-mcp
Cursor / Continue / other MCP clients
Add to your MCP config (~/.cursor/mcp.json or equivalent):
{
"mcpServers": {
"topolift-negotiation": {
"command": "topolift-mcp",
"env": {
"TOPOLIFT_API_KEY": "tl-..."
}
}
}
}
Running directly (no install)
TOPOLIFT_API_KEY=tl-... python -m topolift_mcp.server
Configuration
Environment variables:
| Var | Default | Purpose |
|---|---|---|
TOPOLIFT_API_KEY | (required for negotiate) | Bearer key; get one at https://topolift.ai |
TOPOLIFT_API_URL | https://api.topolift.ai | API base URL |
TOPOLIFT_TIMEOUT | 600 | Negotiate-call timeout in seconds |
TOPOLIFT_LOG_LEVEL | INFO | Python logging level |
The dialect tool works without TOPOLIFT_API_KEY — only topolift_negotiate requires it.
Pricing
- Bearer key (this MCP server's path): one-time / monthly plans starting at $50. See https://topolift.ai.
- x402 micropayment: agents can pay $0.10 USDC per call directly against
https://api.topolift.ai/v1/negotiatewith no API key — see the API's 402 challenge for details.
How it works
- Your agent calls
topolift_dialectonce and learns the vocabulary. - Your agent calls
topolift_negotiatewith a scenario. - 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.
- Your agent parses
topologyfor machine-readable structure and reads the prose fields with citation-traceable evidence.
The 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.
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
TOPOLIFT_API_KEYsecretBearer key from topolift.ai (Stripe-provisioned). Required for topolift_negotiate; topolift_dialect works without it. Autonomous agents can pay per call via x402 directly against the API instead.
TOPOLIFT_API_URLdefault: https://api.topolift.aiAPI base URL. Override only if pointing at a non-default deployment.
TOPOLIFT_TIMEOUTdefault: 600Negotiate-call timeout in seconds. Default 600.