Server data from the Official MCP Registry
Read-only prediction market data (Polymarket, Kalshi, Limitless) from the Assymetrix Data API.
About
Read-only prediction market data (Polymarket, Kalshi, Limitless) from the Assymetrix Data API.
Security Report
This is a read-only Assymetrix prediction market data MCP server that authenticates with a user-supplied API key from an environment variable and only contacts the Assymetrix API over https. The code is well-structured, with redirect refusal, key redaction in logs, and a refusal of non-https base URLs, and the only findings are informational or low, mainly that the three tool implementation files were not included in the review. Supply chain analysis found 2 known vulnerabilities in dependencies (1 critical, 0 high severity). Package verification found 1 issue.
12 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: ASSYMETRIX_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@assymetrix/mcp-server@0.1.1"
],
"env": {
"ASSYMETRIX_API_KEY": "your-assymetrix-api-key-here"
}
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
Assymetrix agent tools
Prediction market data from Polymarket, Kalshi and Limitless for AI agents, from the Assymetrix Data API:
@assymetrix/mcp-server: an MCP server with three read-only tools, inpackages/mcp-server.prediction-market-data: an Agent Skill that teaches an agent to use the same API withcurl, inskills/prediction-market-data.- A Claude Code plugin that bundles both (
.claude-plugin/).
Everything here only reads market data. Nothing places orders, moves money or links wallets, and nothing here is financial advice. You use your own Assymetrix API key, and a free key works.
Get an API key
- Create a free account at https://dashboard.assymetrix.com/signup?utm_source=github&utm_campaign=agent-tools
- Open API Keys and create a key. It is shown once and starts with
asy_. - Keep it in an environment variable, for example in your shell profile:
export ASSYMETRIX_API_KEY=asy_...
The Free plan includes 10,000 requests per rolling 30 days, 1 request per second and 30 days of history. Each tool call is one request. Paid plans: https://dashboard.assymetrix.com/billing
Install
Recommended: the Claude Code plugin (MCP server and skill)
/plugin marketplace add assymetrix/assymetrix-agent-tools
/plugin install assymetrix@assymetrix
Claude Code asks for your API key when you enable the plugin and keeps it in your system's secure store, so the key never sits in a config file or the chat.
Other clients
These read the key from an environment variable or their own config file. Keep the key in your shell profile (export ASSYMETRIX_API_KEY=asy_...) rather than typing it into a command.
Claude Code without the plugin (--transport goes before the name):
claude mcp add --env ASSYMETRIX_API_KEY="$ASSYMETRIX_API_KEY" --transport stdio assymetrix -- npx -y @assymetrix/mcp-server
Codex:
codex mcp add assymetrix --env ASSYMETRIX_API_KEY="$ASSYMETRIX_API_KEY" -- npx -y @assymetrix/mcp-server
Cursor (~/.cursor/mcp.json or .cursor/mcp.json):
{
"mcpServers": {
"assymetrix": {
"command": "npx",
"args": ["-y", "@assymetrix/mcp-server"],
"env": { "ASSYMETRIX_API_KEY": "${env:ASSYMETRIX_API_KEY}" }
}
}
}
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"assymetrix": {
"command": "npx",
"args": ["-y", "@assymetrix/mcp-server"],
"env": { "ASSYMETRIX_API_KEY": "asy_..." }
}
}
}
VS Code (.vscode/mcp.json, which asks for the key and hides it):
{
"inputs": [
{
"type": "promptString",
"id": "assymetrix-key",
"description": "Assymetrix API key",
"password": true
}
],
"servers": {
"assymetrix": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@assymetrix/mcp-server"],
"env": { "ASSYMETRIX_API_KEY": "${input:assymetrix-key}" }
}
}
}
Skill only (Claude Code, Codex, Cursor and other agents)
npx skills add assymetrix/assymetrix-agent-tools
The skill reads ASSYMETRIX_API_KEY from the agent's environment and never prints it.
Tools
| Tool | What it returns |
|---|---|
search_markets | Markets whose question contains your text, sorted by 24-hour volume: id, venue, last price, best bid and ask, end date. |
get_market_prices | One market's current odds: last price, bid, ask, spread, price changes, each outcome's price, volume and liquidity. |
get_market_history | OHLCV candles for a time range (the interval is picked to fit), or the market's trades, newest first. |
Prices are probabilities from 0 to 1. How far back history goes depends on your plan; when your plan cuts a range, the result says so.
Configuration
| Variable | Default | Meaning |
|---|---|---|
ASSYMETRIX_API_KEY | none | Your API key. Without it the server starts and explains how to get one. |
ASSYMETRIX_API_BASE_URL | https://api.assymetrix.com/api/v1 | Only for testing. Must be https (plain http only for localhost). |
ASSYMETRIX_TIMEOUT_MS | 15000 | Timeout for one API request, 1000 to 60000. |
ASSYMETRIX_LOG_LEVEL | warn | error, warn, info or debug. Logs go to stderr. |
Privacy
- The MCP server talks only to the Assymetrix Data API, sending your key in the
x-api-keyheader, aUser-Agentwith its version, and a random request id that support can use to find a call. - It collects no telemetry, writes nothing to disk, and never logs or returns your key.
- The skill runs
curlagainst the same API from your own machine. - Privacy policy: https://www.assymetrix.com/privacy-policy. Support: support@assymetrix.com.
Development
cd packages/mcp-server
pnpm install
pnpm run check # type check, build, then the tests (no network)
node ../../skills/validate-skill.cjs ../../skills/prediction-market-data # skill format checks
node ../../skills/validate-skill.cjs ../../skills/prediction-market-data --release # also fails on open TODO markers
License
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
