OpenFinance — Easy Trading: Crypto, Stocks, Perps & Prediction Markets

OAuth（推奨）

claude mcp add --transport http openfinance-tech https://api.openfinance.tech/agent/mcp

Claude Codeを起動し、/mcpを実行して、openfinance-techを選び、Authenticateを選択します。すべてのプロジェクトで使用できるようにするには、--scope userを追加します。

APIキー

claude mcp add --transport http openfinance-tech https://api.openfinance.tech/agent/mcp \
  --header "x-api-key: $OPENFINANCE_API_KEY"

共有プロジェクト設定（.mcp.json）：Claude Codeは環境変数を展開するため、キーがファイルに保存されることはありません。

{
  "mcpServers": {
    "openfinance-tech": {
      "type": "http",
      "url": "https://api.openfinance.tech/agent/mcp",
      "headers": { "x-api-key": "${OPENFINANCE_API_KEY}" }
    }
  }
}

1. Settings → Connectorsを開き、Add custom connectorをクリックします。
2. 名前：OpenFinance。URL：https://api.openfinance.tech/agent/mcp。
3. Add、次にConnectをクリックし、OpenFinanceで接続を承認します。
4. チャットでツールメニューを開き、OpenFinanceをオンにします。

Claude.aiで追加したコネクターはClaude Desktopにも表示されます。カスタムコネクターを利用するにはClaudeの有料プランが必要です。TeamおよびEnterpriseでは、事前にオーナーによる追加が必要な場合があります。

APIキーを使う方法（Claude Desktopのみ）。 mcp-remoteを使って、claude_desktop_config.json（Settings → Developer → Edit Config）からサーバーに接続します。その後、Claudeを完全に終了して再起動します。

{
  "mcpServers": {
    "openfinance-tech": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.openfinance.tech/agent/mcp",
        "--header", "x-api-key:${OPENFINANCE_API_KEY}"
      ],
      "env": { "OPENFINANCE_API_KEY": "open_..." }
    }
  }
}

1. Settings → Apps & Connectorsを開きます。Createボタンが表示されない場合は、Advanced settingsでDeveloper modeをオンにします。
2. Createをクリックします。名前：OpenFinance。MCPサーバーのURL：https://api.openfinance.tech/agent/mcp。認証：OAuth。
3. 保存し、OpenFinanceにサインインして接続を承認します。
4. 新しいチャットで、ツールまたはコネクターのメニューからOpenFinanceを選択します。

カスタムコネクターを使用するには、対応するChatGPTプラン（Plus、Pro、Business、EnterpriseまたはEdu）が必要です。ワークスペースの管理者による許可が必要な場合があります。

**Cursorに追加**をクリックするか、次の設定を~/.cursor/mcp.json（すべてのプロジェクト）または.cursor/mcp.json（1つのプロジェクト）に追加します。

{
  "mcpServers": {
    "openfinance-tech": {
      "url": "https://api.openfinance.tech/agent/mcp"
    }
  }
}

Cursorでは、サーバーの横にNeeds loginと表示されます。これをクリックしてOpenFinanceにサインインします。

APIキー

{
  "mcpServers": {
    "openfinance-tech": {
      "url": "https://api.openfinance.tech/agent/mcp",
      "headers": { "x-api-key": "${env:OPENFINANCE_API_KEY}" }
    }
  }
}

**VS Code にインストール**をクリックするか、コマンドパレットから MCP: Add Server を実行して URL を貼り付けます。VS Code では OAuth を使ってサインインします。

API キーの場合は、VS Code でキーを一度入力すると、安全に保存されます（.vscode/mcp.json またはユーザーの mcp.json）。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "openfinance-api-key",
      "description": "OpenFinance API key",
      "password": true
    }
  ],
  "servers": {
    "openfinance-tech": {
      "type": "http",
      "url": "https://api.openfinance.tech/agent/mcp",
      "headers": { "x-api-key": "${input:openfinance-api-key}" }
    }
  }
}

VS Code では mcpServers ではなく servers を使用します。Copilot Chat を開き、Agent モードに切り替えると、ツールピッカーに OpenFinance のツールが表示されます。

codex mcp add openfinance-tech --url https://api.openfinance.tech/agent/mcp

Codex からサインインを求められた場合は、codex mcp login openfinance-tech を実行してください。

API キーを環境から読み込む場合は、~/.codex/config.toml に設定します。

[mcp_servers.openfinance-tech]
url = "https://api.openfinance.tech/agent/mcp"
env_http_headers = { "x-api-key" = "OPENFINANCE_API_KEY" }

CLI と IDE 拡張機能はこの設定を共有します。Codex で /mcp を実行して、サーバーが接続されていることを確認してください。

~/.gemini/settings.json に追加します。

{
  "mcpServers": {
    "openfinance-tech": {
      "httpUrl": "https://api.openfinance.tech/agent/mcp"
    }
  }
}

次に、/mcp auth openfinance-tech を実行してサインインします。代わりに API キーを使用する場合は、"headers": { "x-api-key": "$OPENFINANCE_API_KEY" } を追加してください。

Cascade を開き、ハンマーアイコンをクリックしてから Configure を選択し、次を追加します。

{
  "mcpServers": {
    "openfinance-tech": {
      "serverUrl": "https://api.openfinance.tech/agent/mcp",
      "headers": { "x-api-key": "${env:OPENFINANCE_API_KEY}" }
    }
  }
}

Windsurf では url ではなく serverUrl を使用します。保存後、サーバーリストを更新してください。

Cline パネルで MCP Servers → Configure MCP Servers を開き、次を追加します。

{
  "mcpServers": {
    "openfinance-tech": {
      "type": "streamableHttp",
      "url": "https://api.openfinance.tech/agent/mcp",
      "headers": { "x-api-key": "open_..." }
    }
  }
}

Cline では、トランスポートタイプに streamableHttp を使用します。このファイルはお使いのマシンに保存されます。コミットしないでください。

Settings → Connectors → + Add Connectors → Custom MCP → + Add Custom MCP → Direct Configuration：

• 名前：OpenFinance
• トランスポート：Streamable HTTP
• サーバー URL：https://api.openfinance.tech/agent/mcp
• ヘッダー：x-api-key: open_...

hermes mcp add openfinance-tech --url https://api.openfinance.tech/agent/mcp

または、~/.hermes/config.yaml に追加します。

mcp_servers:
  openfinance-tech:
    url: "https://api.openfinance.tech/agent/mcp"
    headers:
      x-api-key: "open_..."

/reload-mcp を実行するか、エージェントを再起動してください。

~/.openclaw/openclaw.json に追加します（ネストされた mcp.servers キーに注意してください）。

{
  "mcp": {
    "servers": {
      "openfinance-tech": {
        "url": "https://api.openfinance.tech/agent/mcp",
        "headers": { "x-api-key": "open_..." }
      }
    }
  }
}

クライアントがローカル（stdio）サーバーにしか対応していない場合は、npx -y mcp-remote https://api.openfinance.tech/agent/mcp でブリッジしてください。

npm install @modelcontextprotocol/sdk

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://api.openfinance.tech/agent/mcp"),
  { requestInit: { headers: { "x-api-key": process.env.OPENFINANCE_API_KEY! } } },
);

const client = new Client({ name: "my-trading-agent", version: "1.0.0" });
await client.connect(transport);

const { tools } = await client.listTools();
console.log(tools.map((t) => t.name));

// Read-only: mid prices for every Hyperliquid market
const mids = await client.callTool({
  name: "hyperliquid",
  arguments: { action: "get_all_mids" },
});
console.log(mids.content);

pip install mcp

import asyncio, os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://api.openfinance.tech/agent/mcp"

async def main():
    headers = {"x-api-key": os.environ["OPENFINANCE_API_KEY"]}
    async with streamablehttp_client(URL, headers=headers) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

            # Read-only: mid prices for every Hyperliquid market
            mids = await session.call_tool("hyperliquid", {"action": "get_all_mids"})
            print(mids.content)

asyncio.run(main())

get_deposit_address で取得したアドレスに、Arbitrum 上の USDC を送金して Hyperliquid アカウントに入金します。出金先は、Arbitrum 上の同じアドレスです。

Polymarket の注文は、メインウォレットではなく Polymarket の入金用ウォレットから決済されます。入金する前に get_deposit_wallet で確認してください。

✍️ launch、simulate_launch、list_launches、get_launch、get_funding、list_creator_launches、get_raffle、get_raffle_claims、list_raffle_stocks、get_readiness、get_keeper_status

✍️ launch、✍️ buy、✍️ sell、✍️ graduate、✍️ claim_fees、list_launches、get_readiness、list_quote_assets、get_pair_terms、get_pool、get_market、get_candles、get_quote、get_fees

✍️ launch_token、✍️ buy、✍️ sell、✍️ migrate、✍️ claim_creator_fees、list_tokens、get_pool_state、quote_buy、quote_sell、get_pool_fees、get_creator_fees

list_quote_assets、get_launch_terms、list_tokens、get_claimable_fees、✍️ enable_holder_fee_sharing、✍️ sweep_fees、✍️ claim_fees、✍️ launch_token（レガシー。新しいローンチには openfinance-launchpad-wrapper を使用）

いいえ。OpenFinance はホスト型のリモート MCP サーバーです。クライアントに URL を追加するだけで、パッケージや Docker イメージ、ローカルプロセスは必要ありません。

Streamable HTTP 経由のリモート MCP サーバーに対応しているクライアントなら、どれでも使えます。Claude（Web、デスクトップ、Claude Code）、ChatGPT、Cursor、VS Code、Codex、Gemini CLI、Windsurf、Cline、Manus、Hermes、OpenClaw などが該当します。ローカルサーバーのみに対応するクライアントでは、mcp-remote を使用できます。

すべての書き込みツールは、エージェントに概要を表示して明示的な確認を待つよう指示します。また、クライアントの承認プロンプトが二重の確認として機能します。どちらも有効にしておいてください。エージェントが指示に従うかどうかは、最終的にはモデルとクライアントに依存するため、資金が動く操作には必ず関与してください。

お客様の OpenFinance アカウントです。同じウォレットを OpenFinance アプリと MCP の両方で使用します。秘密鍵は Settings → Export Keys からエクスポートできます。

ウォレットアドレスに暗号資産を送金する（get_wallet_addresses をエージェントに尋ねてください）か、get_onramp_url で法定通貨の入金用リンクを取得するよう依頼してください。Hyperliquid と Polymarket にはそれぞれ独自の入金アドレスがあり、エージェントに両方を取得させることができます。

MCP サーバーは、価格、注文、送金を扱うライブのツールレイヤーです。Skills は、これらのツールを使って適切に判断する方法をエージェントに教えるプレイブックです。最良の結果を得るには、両方をインストールしてください。