Back to Browse

Assymetrix Agent Tools MCP Server

Developer ToolsModerate6.3MCP RegistryLocal
Free

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

6.3
Moderate6.3Moderate Risk

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.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your Assymetrix Data API key (starts with asy_). A free key works.Required

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 GitHub

From the project's GitHub README.

Assymetrix agent tools

Prediction market data from Polymarket, Kalshi and Limitless for AI agents, from the Assymetrix Data API:

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

  1. Create a free account at https://dashboard.assymetrix.com/signup?utm_source=github&utm_campaign=agent-tools
  2. Open API Keys and create a key. It is shown once and starts with asy_.
  3. 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

ToolWhat it returns
search_marketsMarkets whose question contains your text, sorted by 24-hour volume: id, venue, last price, best bid and ask, end date.
get_market_pricesOne market's current odds: last price, bid, ask, spread, price changes, each outcome's price, volume and liquidity.
get_market_historyOHLCV 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

VariableDefaultMeaning
ASSYMETRIX_API_KEYnoneYour API key. Without it the server starts and explains how to get one.
ASSYMETRIX_API_BASE_URLhttps://api.assymetrix.com/api/v1Only for testing. Must be https (plain http only for localhost).
ASSYMETRIX_TIMEOUT_MS15000Timeout for one API request, 1000 to 60000.
ASSYMETRIX_LOG_LEVELwarnerror, 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-key header, a User-Agent with 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 curl against 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

MIT

Reviews

No reviews yet

Be the first to review this server!