# Tomahawk > One API for perpetuals across Hyperliquid, Aster, Lighter and Pacifica with one routed order, plus the Solana memecoin board and trading. REST under /api/v2, a realtime WebSocket at /ws and a hosted MCP server. Agents use scoped bearer keys. Paper trading is open: renko_sk_test_... keys trade on a simulator only. Live trading is not switched on yet: live keys cannot be created and live actions answer live_off. Order size limits, leverage, slippage, venue and market allow-lists are enforced by the server on every order. ## Start here - API base: https://usetomahawk.xyz/api/v2 . Auth: `Authorization: Bearer renko_sk_...` . Every response is `{ok, data, ts}` or `{ok:false, error:{code,message}, ts}`. - Realtime: wss://renko-terminal-api.fly.dev/ws . Send `{"op":"hello","v":1,"token":"renko_sk_..."}` then `{"op":"sub","id":1,"ch":"book","params":{"symbol":"BTC"}}`. - Hosted MCP: POST /api/v2/mcp (alias /mcp) with the same bearer key. A stdio server is in packages/mcp of the repository; it is not on npm. - TypeScript: plain fetch (see the TypeScript client page). The typed client in packages/sdk is not published to npm. - List the tools with their JSON schemas: GET /api/v2/agent/tools (public). - Safety: orders are preview then place with a client UUID (clientId); repeating the id never places twice. Order status `unknown` means the venue call timed out: never re-send, wait for it to resolve. ## Start - [Overview](https://usetomahawk.xyz/docs): What the API exposes, and what is on: paper trading now, live trading not yet. - [Quickstart](https://usetomahawk.xyz/docs/quickstart): Test key, first call, first paper order. Live trading is off. - [Authentication](https://usetomahawk.xyz/docs/authentication): Test keys, scopes and the per-key policy. Live keys cannot be created yet. ## Connect - [MCP server](https://usetomahawk.xyz/docs/mcp): Hosted endpoint POST /api/v2/mcp (alias /mcp) and the local stdio server. - [Tool reference](https://usetomahawk.xyz/docs/mcp#tools): Every tool, its scope and which ones move money. - [Connect a client](https://usetomahawk.xyz/docs/harnesses): Claude Code, Cursor, Claude Desktop and function calling. - [Claude Code](https://usetomahawk.xyz/docs/harnesses#claude-code): claude mcp add, or .mcp.json. - [Cursor](https://usetomahawk.xyz/docs/harnesses#cursor): .cursor/mcp.json with a url and headers. - [Claude Desktop](https://usetomahawk.xyz/docs/harnesses#claude-desktop): claude_desktop_config.json runs the stdio server from this repository. - [Function calling](https://usetomahawk.xyz/docs/harnesses#function-calling): Anthropic and OpenAI tool arrays from GET /api/v2/agent/tools. - [TypeScript client](https://usetomahawk.xyz/docs/sdk): Plain fetch today; the typed client in packages/sdk is not on npm yet. ## REST API - [Reference](https://usetomahawk.xyz/docs/api): Base URL, envelope, routes, the OpenAPI document and the WebSocket. ## Guides - [Safety](https://usetomahawk.xyz/docs/safety): Policy, clientId, order states, the kill switch. - [Limits](https://usetomahawk.xyz/docs/limits): What answers live_off, what a test key cannot do, rate limits as built. ## Optional - [Full reference](https://usetomahawk.xyz/llms-full.txt): routes, auth, realtime protocol, tools, safety rules, inlined. - [OpenAPI spec](https://usetomahawk.xyz/api/v2/openapi.json): OpenAPI 3.1 description, served by the API.