simmer-mcp-setup
One-shot bootstrap for the Simmer MCP server. Detects your agent runtime (Claude Code / Cursor / OpenClaw / Hermes / Codex / Grok Bot), installs simmer-mcp via npm, writes the right MCP config, prompts a restart, and verifies the tool handshake. Use after registering an agent on simmer.markets to run pre-built Simmer trading strategies through your MCP-aware agent.
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 11, 2026
Version
0.3.6
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 11, 2026
- Latest release
- 0.3.6release · observed Sep 30, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17eez0vajry6hjb97y9mbtv2s85wekv:simmer-mcp-setup- Install using `clawhub skill install s17eez0vajry6hjb97y9mbtv2s85wekv:simmer-mcp-setup` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/simmer/simmer-mcp-setup before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer-mcp-setup/snapshot"
Documentation
CLAWHUB
145,381 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: simmer-mcp-setup
version: "0.3.6"
published: true
description: One-shot bootstrap for the Simmer MCP server. Detects your agent runtime (Claude Code / Cursor / OpenClaw / Hermes / Codex / Grok Bot), installs simmer-mcp via npm, writes the right MCP config, prompts a restart, and verifies the tool handshake. Use after registering an agent on simmer.markets to run pre-built Simmer trading strategies through your MCP-aware agent.
metadata:
author: "Simmer (@simmer_markets)"
version: "0.3.6"
displayName: Simmer MCP Setup
difficulty: beginner
primaryEnv: SIMMER_API_KEY
envVars:
- name: SIMMER_API_KEY
required: true
description: "Your Simmer SDK API key (from agent registration or simmer.markets/dashboard)."
---
# Simmer MCP Setup
One-shot bootstrap that wires the Simmer MCP server into your agent runtime. Read-once, run-once — after this completes, the skill itself isn't needed again.
## What the Simmer MCP is (and isn't)
The Simmer MCP gives your agent raw market/trade tools plus a small pinned catalog of **core Simmer skills** it can invoke as tools. Strategy skills such as `polymarket-copytrading`, `polymarket-fast-loop`, and `kalshi-weather-trader` install on demand from ClawHub instead of shipping inside the npm package.
**What this MCP is for:** querying markets, checking account state, placing guarded direct trades, and running the core bundled Simmer playbooks through your agent. For situational strategies, ask the agent to install the current ClawHub skill first (for example, `clawhub install polymarket-copytrading`) and then follow that skill's instructions. Real trades land on the configured venue — paper `sim` by default, real venues require an explicit triple opt-in (`dry_run=false` + `venue=polymarket|kalshi` + `SIMMER_MCP_ALLOW_LIVE=true` env var on the MCP server).
**Raw trade primitives (added in MCP v3.3.0):** the MCP now exposes raw primitives as standalone tools alongside the per-skill executors — `simmer_get_markets`, `simmer_get_market_context`, `simmer_get_briefing`, `simmer_trade`, `simmer_cancel_order`, and `get_portfolio`/`get_positions`/`get_expiring_positions`. So ad-hoc operations like *"show me Polymarket markets for the world cup"* or *"place a $2 paper YES on this market"* now work directly through MCP. `simmer_trade` is **paper-by-default** — live execution needs the triple gate (`dry_run=false` + a live `trading_venue` + `SIMMER_MCP_ALLOW_LIVE=true`). The [Python SDK](https://clawhub.ai/skills/simmer) still offers the fullest primitive surface (`client.trade()`, `client.get_briefing()`, etc.) for custom logic.
So: MCP and SDK are different shapes, both legitimate. MCP runs pre-built strategies *and* raw primitives through your agent with safety defaults; the SDK builds custom logic with full primitive access.
## What you'll have at the end
- `simmer-mcp` runnable via `npx -y [email protected]` (global install optional)
- Optionally `simmer-sdk` on the host plus `SIMMER_MCP_meta.json
{
"ownerId": "kn7axnp7bzqsf5fkx0z8px7han7zyq1x",
"slug": "simmer-mcp-setup",
"version": "0.3.6",
"publishedAt": 1790752618117
}skill-card.md
## Description: Guides users through installing and configuring the Simmer MCP server in their agent runtime, then verifying its trading tools are available. This skill is ready for commercial/non-commercial use. ## Publisher: [simmer](https://clawhub.ai/user/simmer) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agent users configure Simmer market and trading tools for an MCP-aware runtime after registering an agent and obtaining an API key. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The installed server grants persistent access to Simmer market and trading tools in the chosen agent runtime. Mitigation: Install only when needed and prefer local or project scope where available. Risk: An API key stored on a shared or cloud machine could expose trading access. Mitigation: Avoid storing live-trading keys on shared or cloud machines. Risk: Enabling live-trading settings can permit real-money orders. Mitigation: Keep the default paper/sim behavior unless deliberately enabling the live-trading gates. ## Reference(s): - [Simmer documentation](https://docs.simmer.markets) - [simmer-mcp npm package](https://www.npmjs.com/package/simmer-mcp) - [Simmer wallet setup for real-money trading](https://clawhub.ai/skills/simmer-wallet-setup) - [Simmer Python SDK skill](https://clawhub.ai/skills/simmer) ## Skill Output: **Output Type(s):** [Configuration instructions, Shell commands, Guidance] **Output Format:** [Markdown with shell commands and MCP configuration examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Runtime-specific setup and verification steps; requires SIMMER_API_KEY for authenticated tools.] ## Skill Version(s): 0.3.6 (source: frontmatter and ClawHub release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
clawhub.json
{
"emoji": "🔌",
"primaryEnv": "SIMMER_API_KEY",
"requires": {
"env": [
"SIMMER_API_KEY"
],
"system": [
"node",
"npm"
]
},
"envVars": [
{
"name": "SIMMER_API_KEY",
"required": true,
"description": "Your Simmer SDK API key (from agent registration or simmer.markets/dashboard)."
}
],
"cron": null,
"autostart": false,
"automaton": {
"managed": false,
"entrypoint": null
}
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/simmer/skills/simmer-mcp-setup",
"sourceUrl": "https://clawhub.ai/simmer/skills/simmer-mcp-setup",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T03:17:58.706Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer-mcp-setup/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer-mcp-setup/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T03:17:58.706Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/simmer/simmer-mcp-setup",
"sourceUrl": "https://clawhub.ai/simmer/simmer-mcp-setup",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T03:17:58.706Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.3.6",
"href": "https://clawhub.ai/simmer/simmer-mcp-setup",
"sourceUrl": "https://clawhub.ai/simmer/simmer-mcp-setup",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-30T07:16:58.117Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer-mcp-setup/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-simmer-simmer-mcp-setup/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.3.6",
"description": "- Updated to refer to simmer-mcp version 3.5.8 wherever npx/bunx install is mentioned, ensuring correct version locking for MCP launches. - Version bumped to 0.3.6 in metadata and SKILL.md. - Removed redundant file: skill-card.md, simplifying the repo contents. - No changes to feature scope or behavior; only versioning, documentation, and minor usage update.",
"href": "https://clawhub.ai/simmer/simmer-mcp-setup",
"sourceUrl": "https://clawhub.ai/simmer/simmer-mcp-setup",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-30T07:16:58.117Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
