assymetrix

Assymetrix エージェントツール

Assymetrix Data API による、AI エージェント向けの Polymarket、Kalshi、Limitless の予測市場データです。

• @assymetrix/mcp-server：3 つの読み取り専用ツールを備えた MCP サーバーです。場所は packages/mcp-server です。
• prediction-market-data：エージェントが curl で同じ API を使えるようにする Agent Skill です。場所は skills/prediction-market-data です。
• Claude Code プラグイン：上記の両方を同梱しています（.claude-plugin/）。

ここにある機能はすべて、市場データを読み取るだけです。注文の発注、資金の移動、ウォレットのリンクは一切行わず、ここで提供する情報は金融アドバイスではありません。ご自身の Assymetrix API キーを使用します。無料のキーも利用できます。

API キーを取得する

1. https://dashboard.assymetrix.com/signup?utm_source=github&utm_campaign=agent-tools で無料アカウントを作成します。
2. API Keys を開いてキーを作成します。キーは一度だけ表示され、asy_ で始まります。
3. シェルのプロファイルなどで環境変数に設定します。例：export ASSYMETRIX_API_KEY=asy_...

Free プランには、ローリング 30 日間で 10,000 リクエスト、毎秒 1 リクエスト、30 日分の履歴が含まれます。ツール呼び出し 1 回につき、リクエスト 1 件として数えられます。有料プランについては https://dashboard.assymetrix.com/billing をご覧ください。

インストール

推奨：Claude Code プラグイン（MCP サーバーとスキル）

/plugin marketplace add assymetrix/assymetrix-agent-tools
/plugin install assymetrix@assymetrix

プラグインを有効にすると、Claude Code が API キーを求め、システムのセキュアストアに保存します。そのため、キーが設定ファイルやチャットに残ることはありません。

その他のクライアント

これらは環境変数または各クライアントの設定ファイルからキーを読み込みます。キーをコマンドに入力するのではなく、シェルのプロファイルに設定してください（export ASSYMETRIX_API_KEY=asy_...）。

プラグインを使わない Claude Code（--transport は名前の前に指定します）：

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 または .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。キーを求める画面が表示され、キーは非表示になります）：

{
  "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}" }
    }
  }
}

スキルのみ（Claude Code、Codex、Cursor、その他のエージェント）

npx skills add assymetrix/assymetrix-agent-tools

スキルはエージェントの環境から ASSYMETRIX_API_KEY を読み込み、キーを表示することはありません。

ツール

ツール	返される内容
search_markets	指定したテキストを質問文に含む市場を、24 時間の取引高順に返します。内容：ID、取引所、最終価格、最良買値と最良売値、終了日。
get_market_prices	1 つの市場の現在のオッズを返します。内容：最終価格、買値、売値、スプレッド、価格変動、各結果の価格、取引高、流動性。
get_market_history	指定期間の OHLCV ローソク足（期間に収まるよう間隔を選択）、または市場の取引履歴を新しい順に返します。

価格は 0 から 1 までの確率です。履歴をどこまでさかのぼれるかはプランによって異なります。プランの上限によって期間が短縮される場合は、結果にその旨が表示されます。

設定

変数	デフォルト値	説明
ASSYMETRIX_API_KEY	なし	API キーです。設定されていなくてもサーバーは起動し、取得方法を案内します。
ASSYMETRIX_API_BASE_URL	https://api.assymetrix.com/api/v1	テスト専用です。https が必須です（localhost の場合のみ通常の http を使用できます）。
ASSYMETRIX_TIMEOUT_MS	15000	1 回の API リクエストのタイムアウトです。1000～60000 を指定できます。
ASSYMETRIX_LOG_LEVEL	warn	error、warn、info、debug のいずれかです。ログは stderr に出力されます。

プライバシー

• MCP サーバーは Assymetrix Data API とのみ通信し、x-api-key ヘッダーにキーを入れ、バージョン情報を含む User-Agent と、サポートが呼び出しを特定するために使用できるランダムなリクエスト ID を送信します。
• テレメトリーを収集せず、ディスクへの書き込みも行わず、キーをログに記録したり返したりすることもありません。
• スキルは、お使いのマシンから同じ API に対して curl を実行します。
• プライバシーポリシー：https://www.assymetrix.com/privacy-policy。サポート：[email protected]。

開発

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

ライセンス

MIT