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）。 通过 claude_desktop_config.json 中的 mcp-remote 桥接该服务端（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）；工作区管理员可能需要先允许使用自定义连接器。

点击 Add to Cursor，或将以下内容添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "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 使用 servers，而非 mcpServers。打开 Copilot Chat，切换到 Agent 模式，OpenFinance 工具便会出现在工具选择器中。

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

如果 Codex 要求你登录，请运行 codex mcp login openfinance-tech。

在 ~/.codex/config.toml 中使用API 密钥，从环境变量读取：

[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 使用 serverUrl，而非 url。保存后刷新服务列表。

在 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，或重启 Agent。

在 ~/.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（网页端、桌面端和 Claude Code）、ChatGPT、Cursor、VS Code、Codex、Gemini CLI、Windsurf、Cline、Manus、Hermes 和 OpenClaw。仅支持本地服务的客户端可以使用 mcp-remote。

每个写入工具都会要求 Agent 显示摘要并等待你的明确确认，而客户端的审批提示会再进行一次检查。请保持两项检查都处于开启状态。Agent 是否遵循指令最终取决于模型和客户端，因此任何会动用资金的操作都请务必亲自确认。

你的 OpenFinance 账户。OpenFinance 应用和 MCP 使用相同的钱包，你可以在 Settings → Export Keys 中导出钱包私钥。

向你的钱包地址转入加密货币（让 Agent 调用 get_wallet_addresses 查询），或让 Agent 使用 get_onramp_url 获取法币入金链接。Hyperliquid 和 Polymarket 各有自己的存款地址；Agent 可以查询这两个地址。

MCP 服务是实时工具层，提供价格、订单和转账等功能。Skills 则是操作指南，帮助 Agent 学会合理使用这些工具。建议两者都安装，以获得最佳效果。