OpenFinance — Easy Trading

OAuth (recommended)

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

Start Claude Code, run /mcp, choose openfinance-tech and select Authenticate. Add --scope user to make it available in every project.

API key

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

Shared project config (.mcp.json): Claude Code expands environment variables, so the key never lands in the file:

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

1. Open Settings → Connectors and click Add custom connector.
2. Name: OpenFinance. URL: https://api.openfinance.tech/agent/mcp.
3. Click Add, then Connect, and approve the connection on OpenFinance.
4. In a chat, open the tools menu and switch OpenFinance on.

Connectors you add on Claude.ai also appear in Claude Desktop. Custom connectors are available on Claude's paid plans; on Team and Enterprise an owner may need to add them first.

API key alternative (Claude Desktop only). Bridge the server through mcp-remote in claude_desktop_config.json (Settings → Developer → Edit Config), then fully quit and reopen 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. Open Settings → Apps & Connectors. If you don't see a Create button, turn on Developer mode under Advanced settings.
2. Click Create. Name: OpenFinance. MCP server URL: https://api.openfinance.tech/agent/mcp. Authentication: OAuth.
3. Save, sign in to OpenFinance and approve the connection.
4. In a new chat, pick OpenFinance from the tools or connectors menu.

Custom connectors need a ChatGPT plan that supports them (Plus, Pro, Business, Enterprise or Edu); workspace admins may need to allow them.

Click Add to Cursor, or add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

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

Cursor shows Needs login next to the server. Click it to sign in to OpenFinance.

API key

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

Click Install in VS Code, or run MCP: Add Server from the Command Palette and paste the URL. VS Code signs you in with OAuth.

API key, with VS Code prompting for the key once and storing it securely (.vscode/mcp.json or your user 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 uses servers, not mcpServers. Open Copilot Chat, switch to Agent mode, and the OpenFinance tools appear in the tools picker.

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

If Codex asks you to sign in, run codex mcp login openfinance-tech.

API key in ~/.codex/config.toml, read from your environment:

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

The CLI and the IDE extension share this config. Run /mcp in Codex to check the server is connected.

Add to ~/.gemini/settings.json:

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

Then run /mcp auth openfinance-tech to sign in. For an API key instead, add "headers": { "x-api-key": "$OPENFINANCE_API_KEY" }.

Open Cascade, click the hammer icon, then Configure, and add:

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

Windsurf uses serverUrl rather than url. Refresh the server list after saving.

In the Cline panel, open MCP Servers → Configure MCP Servers and add:

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

Cline uses streamableHttp as the transport type. This file is stored on your machine; don't commit it.

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

• Name: OpenFinance
• Transport: Streamable HTTP
• Server URL: https://api.openfinance.tech/agent/mcp
• Header: x-api-key: open_...

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

Or in ~/.hermes/config.yaml:

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

Run /reload-mcp, or restart the agent.

In ~/.openclaw/openclaw.json (note the nested mcp.servers key):

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

If your client only supports local (stdio) servers, bridge it with 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())

Fund your Hyperliquid account by sending USDC on Arbitrum to the address from get_deposit_address. Withdrawals go back to the same address on Arbitrum.

Polymarket orders settle from your Polymarket deposit wallet, not your main wallet. Use get_deposit_wallet to find it before funding.

✍️ 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 (legacy; new launches use openfinance-launchpad-wrapper)

No. OpenFinance is a hosted remote MCP server. You add a URL to your client; there's no package, Docker image or local process.

Any client that supports remote MCP servers over Streamable HTTP, including Claude (web, desktop and Claude Code), ChatGPT, Cursor, VS Code, Codex, Gemini CLI, Windsurf, Cline, Manus, Hermes and OpenClaw. Clients that only support local servers can use mcp-remote.

Every write tool instructs the agent to show a summary and wait for your explicit confirmation, and your client's approval prompts add a second check. Keep both on. Whether an agent follows instructions ultimately depends on the model and client, so stay in the loop for anything that moves money.

Your OpenFinance account. The same wallets are used in the OpenFinance app and over MCP, and you can export their private keys from Settings → Export Keys.

Send crypto to your wallet address (ask your agent for get_wallet_addresses), or ask for a fiat on-ramp link with get_onramp_url. Hyperliquid and Polymarket each have their own deposit address; your agent can fetch both.

The MCP server is the live tool layer: prices, orders, transfers. Skills are playbooks that teach an agent good judgement with those tools. Install both for the best results.