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

[OpenFinance: the trading MCP server for AI agents. Crypto, perps, stocks, prediction markets, forex and memecoins.]

OpenFinance MCP Server

The easiest way to let your AI agent trade.
Research, trade and move money across every major market through one remote MCP connection. No install, no keys to juggle.

[MCP: Streamable HTTP] [Auth: OAuth or API key] [18 tools, 100+ actions] [Docs] [Follow on X] [Discord]

[Add to Cursor]   [Install in VS Code]   [Install in VS Code Insiders]

The OpenFinance MCP server supercharges AI agents with trading skills. Connect Claude, ChatGPT, Cursor, Codex or any MCP client and your agent can:

• Trade crypto spot and perpetuals on Hyperliquid, with limit, market and TWAP orders, leverage and margin control.
• Trade stocks, indices, commodities, forex and pre-IPO names as Hyperliquid HIP-3 perps (for example xyz:NVDA).
• Trade prediction markets on Polymarket: sports, politics, crypto and world events, plus trader leaderboards.
• Swap and bridge anything onchain across 40+ EVM chains and Solana, with Relay and Jupiter routing.
• Find and trade memecoins with token search across 200+ chains, live prices and liquidity.
• Launch tokens on Robinhood Chain and Solana, including tokens paired against tokenized stocks.
• Fund the account with fiat, through card, bank transfer or UPI.

There is nothing to install or host. The server runs at one HTTPS endpoint, and your agent connects to it like any other remote MCP server.

https://api.openfinance.tech/agent/mcp

[!IMPORTANT] This server can place real orders and move real funds. Every write action is designed to ask you first, and you should keep your client's tool-approval prompts switched on. Read Safety and security before you trade.

Contents

• Quick start
• What your agent can do
• Supported chains
• Authentication
• Install in your AI client
• Use it from your own code
• Tool reference
• Example prompts
• Safety and security
• Pair it with OpenFinance Skills
• Verify the connection
• Troubleshooting
• FAQ
• Links

Quick start

Easy trading for your agent in under a minute.

1. Create your account. Sign in at openfinance.tech. Your trading wallets (one EVM address for every EVM chain, plus a Solana address) are created for you.

2. Add the server to your AI client. In Claude Code, for example:

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

3. Sign in and approve. The first time your agent uses the server, your client opens an OpenFinance sign-in page. Approve the connection on the consent screen and you're done.

Then ask your agent something like:

"What's BTC's funding rate on Hyperliquid right now, and how has it moved over the last day?"

Using a different client? See Install in your AI client.

What your agent can do

Supported chains

Authentication

Every call to the server is authenticated. You can sign in two ways; both act on your own OpenFinance account.

OAuth sign-in. The server follows the MCP authorization spec, so supporting clients discover it automatically. When you connect, you sign in to OpenFinance and see which account is being connected; you have to confirm twice before anything is authorized.

API key. Sign in at openfinance.tech, open External AI in the sidebar, and copy the API key shown under Connect OpenFinance to your AI. Keys start with open_.

[!WARNING] Treat your API key like a password. It carries the same permissions as your account, including placing trades and sending funds from your wallets. Keep it in an environment variable or your client's secret prompt, never in a file you commit, and never paste it into a shared chat. If it leaks, replace it straight away.

The examples below read the key from an environment variable:

export OPENFINANCE_API_KEY="open_..."   # add to your shell profile, not to a repo

Install in your AI client

Use the server name openfinance-tech and the URL https://api.openfinance.tech/agent/mcp everywhere. Each section shows the OAuth setup first, then the API-key alternative.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Use it from your own code

Building your own agent? Connect with the official MCP SDKs.

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 marketconst mids = await client.callTool({  name: "hyperliquid",  arguments: { action: "get_all_mids" },});console.log(mids.content);

pip install mcp

import asyncio, osfrom mcp import ClientSessionfrom 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())

[!TIP] Each tool's description tells the model exactly how to use it: which action to pick, what to check before an order, and when to ask the user. Pass the descriptions to your model unchanged for the best results.

Tool reference

18 tools. The larger venues (hyperliquid, polymarket and the launchpads) group many operations behind one tool with an action parameter. Actions marked ✍️ change state: they place orders, move funds or sign transactions.

Trading venues

Swaps, bridges and transfers

Wallet and market data

Token launches

Example prompts

Research

• "Which Hyperliquid perps have the highest funding right now? Show the top 10 with open interest."
• "List every stock perp on Hyperliquid and today's move for NVDA, TSLA and AAPL."
• "What are the odds on Polymarket for the next Fed rate decision? Show me the order book."
• "Who are the top 10 Polymarket traders in sports this month?"
• "Find PEPE on Base and tell me its price, 24h volume and liquidity."

Portfolio

• "What do I hold across all my wallets, in USD?"
• "Show my open Hyperliquid positions with entry price, PnL and liquidation price."
• "What are my open Polymarket positions and my PnL this week?"

Trading (your agent will show you a summary and wait for your yes)

• "Long 0.01 BTC on Hyperliquid at 5x with a limit at 2% below the current price."
• "Buy $25 of YES on the leading Polymarket outcome for the Champions League final."
• "Swap 50 USDC on Polygon for ETH on Base."
• "Swap 1 SOL for BONK."
• "TWAP 500 USDC into ETH perps over 2 hours."

Funding and launches

• "Give me a link to buy $100 of USDC with my card."
• "Launch a token called Rocket (RKT) on Robinhood Chain that burns its trading fees. Simulate it first."

Safety and security

How write actions work. OpenFinance creates your trading wallets when you sign up. When your agent calls a write action (✍️ above), the server signs and submits it from your account. To keep you in control:

• Every write tool tells the agent to confirm with you first. The agent should quote or preview, show you the tokens, amounts, chains, fees and recipient, and wait for your explicit yes in the current conversation.
• Transfers to outside addresses get an extra warning. If the recipient isn't one of your own wallets, the agent must show a clear external-transfer warning before it sends anything.
• Keep your client's approval prompts on. Most clients can ask before each tool call. Leave that on for OpenFinance, and don't add its tools to an auto-approve list. It's your second check if a model ever skips a confirmation.

Protecting your account

• Prefer OAuth sign-in over API keys where your client supports it.
• If you use a key, keep it in an environment variable or a secret prompt. Never commit it, and never paste it into a chat, issue or screenshot.
• Replace your key at once if you think it has been exposed; the old key stops working immediately.
• Revoke clients you no longer use from your OpenFinance account.
• Be careful with prompt injection. Don't ask an agent with trading access to act on instructions from web pages, emails or documents you don't trust, and never let it take an address or amount from that kind of content without checking it yourself.
• You can export your wallets' private keys from Settings → Export Keys in OpenFinance at any time.

This repository is documentation only. It contains no code, no keys, no secrets and no install scripts.

To report a vulnerability, use Report a vulnerability on this repository's Security tab. Please don't open a public issue for security problems. See SECURITY.md.

Pair it with OpenFinance Skills

The MCP server gives your agent the tools. OpenFinance Skills teach it how to use them well: how to size a Hyperliquid perp, read a Polymarket order book, or route a cross-chain swap. They work in Claude Code, Cursor, Codex and most coding agents.

npx skills add openfinance-tech/skills -y

Verify the connection

Check the server is reachable. Without credentials it answers 401 and points your client to sign-in, which is expected:

curl -si https://api.openfinance.tech/agent/mcp \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | head -3

With your API key it lists all 18 tools:

curl -s https://api.openfinance.tech/agent/mcp \  -H "x-api-key: $OPENFINANCE_API_KEY" \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

You can also browse the tools interactively with the MCP Inspector:

npx @modelcontextprotocol/inspector

Choose Streamable HTTP, enter the URL, and sign in or add the x-api-key header.

Troubleshooting

FAQ

Links

• App: openfinance.tech
• Connect your agent: openfinance.tech/agents
• Docs: docs.openfinance.tech · llms.txt
• Skills: openfinance-tech/skills
• X: @openfinancelabs
• Discord: discord.gg/6EA3z4HjSe

Disclaimer

Trading crypto, perpetual futures, prediction markets and other leveraged or volatile products carries a high risk of loss, and you can lose more than you expect. Nothing in this repository or in the server's responses is financial, investment or legal advice. AI agents make mistakes: review every action before you confirm it. Availability of some markets depends on where you live; you're responsible for following the laws that apply to you.

License

The contents of this repository are released under the MIT License.