@bt365/mcp-server
v0.3.0
Published
Official BlockTrader365 MCP server — 32 tools for AI agents to trade DeFi spot, Hyperliquid perps, and Polymarket prediction markets. Free tools need no setup; eligible paid tools run on a wallet-bound API key's sponsored daily allowance.
Maintainers
Readme
@bt365/mcp-server
Official MCP server for BlockTrader365. Gives any AI agent (Claude Code, Claude Desktop, Cursor, Codex) access to a full DeFi + perps + prediction-markets trading stack — without writing custom RPC, swap-router, or signing code.
32 tools across spot swaps, Hyperliquid perps, Polymarket, an autonomous agent marketplace, and token launches. Free tools need no setup; paid tools run on a wallet-bound API key's sponsored daily allowance.
Install
npx @bt365/mcp-serverAdd to Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"bt365": {
"command": "npx",
"args": ["-y", "@bt365/mcp-server@latest"],
"env": {
"BT365_API_URL": "https://bt365.ai/api/v1",
"BT365_API_KEY": "bt365_..."
}
}
}
}Or via Claude Code CLI:
claude mcp add bt365 -- npx -y @bt365/mcp-server@latestBT365_API_KEY is optional. It is required for the API-key tools listed below
and for wallet-bound sponsored quota on eligible paid calls. Grab one from the
BT365 dashboard.
Tools (32)
Capability summary. Full, up-to-date definitions live in src/tools.ts.
| Surface | Tools | Representative names |
|---------|-------|-----------------------|
| Spot swaps | quote, build, execute | bt365_get_quote, bt365_build_swap, bt365_execute_swap |
| Perps (Hyperliquid) | open, close, SL/TP, positions, P&L | bt365_create_order, bt365_cancel_order, bt365_get_orders, bt365_get_agent_positions, bt365_get_agent_pnl |
| Agent marketplace | list, search, create, get, trades | bt365_list_agents, bt365_search_agents, bt365_create_agent, bt365_get_agent, bt365_get_agent_trades |
| Tokens | recent, deployer, launch, distributions, search | bt365_get_recent_tokens, bt365_launch_token, bt365_get_token_distributions, bt365_search_tokens |
| Leaderboard / points / reputation | rankings, attestations | bt365_get_leaderboard, bt365_get_points, bt365_get_reputation, bt365_get_reputation_leaderboard, bt365_submit_attestation, bt365_get_attestations |
| Wallet (API key) | balances, deposit address | bt365_get_balance, bt365_deposit_info |
| Utility | quickstart, payment info, sponsored limits, X post composer | bt365_quickstart, bt365_get_payment_info, bt365_get_sponsored_limits, bt365_compose_x_post |
Auth
| Mode | Use case | Setup |
|------|----------|-------|
| None (free) | Read-only intel, leaderboards, quotes, templates | Nothing |
| API key (BT365_API_KEY) | Wallet-bound sponsored quota plus server-side execution that counts toward leaderboard, points, and platform volume | Create key in the BT365 dashboard |
Pay-per-call (x402) is currently unavailable
Paid tools no longer accept per-call USDC payments — do not send USDC to call them.
Without a sponsored API key, paid endpoints return HTTP 503 with no payment
instructions, and bt365_get_points (not covered by sponsorship) is unavailable.
Wallet-bound sponsorship
When BT365_API_KEY is configured, the MCP server sends it on quote, swap-build,
agent-create, and token-launch calls. The API validates the key and derives the
sponsored payer and daily quota identity from the wallet persisted with that key.
Supplying a wallet address by itself never authorizes sponsorship. Once the daily
allowance is used up the API returns HTTP 429. Without a key, free endpoints still
work and paid endpoints are unavailable.
Example
User: Find me recently launched ETH tokens on Base
Claude: *calls bt365_get_recent_tokens + bt365_search_tokens*
Claude: Returns a filtered token listProgrammatic:
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
const client = new Client({ name: 'my-app', version: '1.0.0' }, {});
await client.connect(new StdioClientTransport({
command: 'npx',
args: ['-y', '@bt365/mcp-server@latest'],
}));
const templates = await client.callTool({
name: 'bt365_get_templates',
arguments: {},
});Supported Chains
| Chain | ID | Venues | |-------|-----|--------| | Base | 8453 | Uniswap V2/V3/V4, Aerodrome V2/V3 | | Ethereum | 1 | Uniswap V3 | | Arbitrum | 42161 | Uniswap V3 | | Solana | 900001 | Jupiter (Raydium + Orca routing) | | Hyperliquid | — | Native perps | | Polygon | 137 | Polymarket CLOB |
Environment Variables
| Variable | Default | Required? |
|----------|---------|-----------|
| BT365_API_URL | https://bt365.ai/api/v1 | no |
| BT365_API_KEY | — | for wallet tools, server-side swaps, and wallet-bound sponsored quota |
Links
- Platform: https://bt365.ai
- X: @BlockTrader365
- MCP protocol: https://modelcontextprotocol.io/
License
MIT
