Agents · MCP
Hosted MCP is https://mcp.dogabot.com/mcp (OAuth or API key).
This catalog lists 76 tools mapped to the API-key allowlist.
Product page
What MCP is and who it is for.
Install
Cursor, Claude, and custom connector setup.
Learn
API keys and MCP how-to.
Each tool maps to one allowlisted REST path. Write tools require matching scopes on the key or OAuth profile
(for example write:terminal, write:lifecycle, write:automation). Prefer paper before live.
Write example
JSON Code
place_terminal_order
{
"exchange": "hyperliquid",
"symbol": "BTC",
"side": "buy",
"quantity": 0.001,
"order_type": "market",
"trading_mode": "paper",
"broadcast_mode": "personal"
}Tool catalog
Machine-readable: /mcp-tools.json.
| Tool | Description | Scopes | REST | |
|---|---|---|---|---|
get_me | Account that owns this API key. | read:account | read | GET /api/v1/me |
list_automations | Filtered summaries of the key owner's automations. | read:automations | read | POST /api/v1/automations/summary |
get_automation | One automation by id (same scopes as follower/bot/emitter/portfolio reads). | read:automations | read | GET /api/v1/followers/:id |
get_pnl_series | Historical PnL points for an automation. | read:automations | read | GET /api/v1/followers/:id/pnl-series |
get_position | Current position for an automation. | read:automations | read | GET /api/v1/followers/:id/position |
get_user_statistics | Aggregated trading statistics for the key owner. | read:account | read | GET /api/v1/me/statistics |
get_positions | Open positions across the key owner's automations. | read:account | read | GET /api/v1/me/positions |
get_available_cash | Sum of live free stable balances across the key owner's credential venues. | read:account | read | GET /api/v1/me/available-cash |
list_orders | Order history for one follower or one bot. | read:orders | read | GET /api/v1/orders |
list_signals | Signal history for one emitter. | read:signals | read | GET /api/v1/signals |
get_backtest_quota | Remaining backtest quota and in-flight limits. | read:backtests | read | GET /api/v1/backtest/quota |
list_backtests | Backtest jobs the key owner can access (compact metrics plus robustness). | read:backtests | read | GET /api/v1/backtests |
get_backtest | One backtest job. Default summary includes robustness gates. | read:backtests | read | GET /api/v1/backtest/:job_id |
summarize_backtest_batch | Rank a bulk backtest batch (best per symbol by default) with compact metrics, robustness gates, and app URLs. | read:backtests | read | GET /api/v1/backtests/summary |
get_backtest_signals | Trades for a backtest (full history is kept briefly). | read:backtests | read | GET /api/v1/backtest/:job_id/signals |
create_backtest | Enqueue a backtest. Check quota first. | write:backtest | write | POST /api/v1/backtest |
cancel_backtest | Cancel a queued or running backtest. | write:backtest | write | POST /api/v1/backtest/:job_id/cancel |
create_backtest_batch | Bulk backtest sweep seeded from an automation or backtest (current config plus added values), or from a full template. Defaults to a draft preview. | write:backtest | write | POST /api/v1/backtest/bulk |
run_backtest_batch | Enqueue a draft bulk batch, or re-run a finished one. | write:backtest | write | POST /api/v1/backtest/bulk/batches/:batch_id/rerun |
list_backtest_batches | Bulk backtest batches with job progress. | read:backtests | read | GET /api/v1/backtest/bulk/batches |
get_backtest_batch | One bulk backtest batch with progress and saved config. | read:backtests | read | GET /api/v1/backtest/bulk/batches/:batch_id |
cancel_backtest_batch | Cancel a running bulk backtest batch. | write:backtest | write | POST /api/v1/backtest/bulk/batches/:batch_id/cancel |
search_marketplace | Search public marketplace listings. | read:markets | read | GET /api/v1/marketplace/search |
list_community_examples | Browse Community examples: public shared backtests (historical sims). | read:backtests | read | GET /api/v1/backtest/community-examples |
get_community_example | Get a Community example or shared backtest by job_id. | read:backtests | read | GET /api/v1/backtest/:job_id |
publish_community_example | Share a completed backtest you own to Community examples. | write:backtest | write | POST /api/v1/backtest/:job_id/community-example |
unpublish_community_example | Remove a backtest from Community examples. | write:backtest | write | DELETE /api/v1/backtest/:job_id/community-example |
list_leaderboard | Public automation leaderboard (same as the app ranking page): platform automations and public listings, ranked, params redacted. | read:automations | read | POST /api/v1/emitters/summary |
list_markets | List markets with optional filters. | read:markets | read | GET /api/v1/markets |
list_exchanges | List supported exchanges. | read:markets | read | GET /api/v1/exchanges |
get_ticker | Latest ticker for an exchange and symbol. | read:markets | read | GET /api/v1/ticker |
get_candles | OHLCV candles for an exchange and symbol. | read:markets | read | GET /api/v1/datafeed/history |
get_symbol_correlation | Pearson correlation for daily buy-and-hold returns across symbols. | read:markets | read | POST /api/v1/markets/symbol-correlation |
get_symbol_volatility | Sample std of daily returns for markets over 7d/30d/90d/365d windows. | read:markets | read | POST /api/v1/markets/symbol-volatility |
get_symbol_fee_breakeven | Minimum price move to break even after entry+exit fees; returns both maker and taker same-role scenarios. | read:markets | read | POST /api/v1/markets/symbol-fee-breakeven |
list_terminal_orders | The key owner's terminal orders. | read:orders | read | GET /api/v1/terminal/orders |
get_terminal_order | One terminal order by client_order_id. | read:orders | read | GET /api/v1/terminal/orders/by-client-order-id/:client_order_id |
list_terminal_positions | The key owner's terminal positions. | read:orders | read | GET /api/v1/terminal/positions |
list_terminal_emitters | Emitters the key owner can use as a terminal leader. | read:automations | read | GET /api/v1/me/emitters |
list_exchange_balances | Live wallet snapshot from a connected exchange. | read:orders | read | GET /api/v1/exchange/balances |
list_exchange_positions | Live venue futures/perp contracts (spot returns empty). | read:orders | read | GET /api/v1/exchange/positions |
get_exchange_margin_summary | Live futures margin summary and liq-distance aggregates. | read:orders | read | GET /api/v1/exchange/margin-summary |
list_exchange_orders | Live venue open + recent filled/canceled orders. | read:orders | read | GET /api/v1/exchange/orders |
list_exchange_trades | Live venue fills (paginated). | read:orders | read | GET /api/v1/exchange/trades |
list_exchange_income | Live venue income/cashflow history. | read:orders | read | GET /api/v1/exchange/income |
get_exchange_openable_notional | Aster remaining openable notional (USDT) at symbol+leverage. | read:orders | read | GET /api/v1/exchange/openable-notional |
set_exchange_leverage | Change initial futures leverage on perp venues, optional margin_mode (confirm_live required). | write:terminal | write | POST /api/v1/exchange/leverage |
set_exchange_margin_mode | Switch cross/isolated margin for a symbol (confirm_live required). | write:terminal | write | POST /api/v1/exchange/margin-mode |
get_exchange_leverage_capabilities | Static per-venue leverage and margin-mode support matrix. | read:orders | read | GET /api/v1/exchange/leverage-capabilities |
get_terminal_symbol_rules | Lot size, min quantity, and min notional for a venue symbol. | read:markets | read | GET /api/v1/terminal/symbol-rules |
get_terminal_order_capabilities | Venue-native order capabilities (stops, brackets, post-only). | read:markets | read | GET /api/v1/terminal/order-capabilities |
place_terminal_order | Place a terminal order (async ack). Prefer paper. | write:terminal | write | POST /api/v1/terminal/place-order |
cancel_terminal_order | Cancel a resting terminal order. | write:terminal | write | POST /api/v1/terminal/cancel-order |
cancel_exchange_order | Cancel one live venue resting order. | write:terminal | write | POST /api/v1/exchange/cancel-order |
cancel_exchange_orders | Bulk-cancel live venue resting orders. | write:terminal | write | POST /api/v1/exchange/cancel-orders |
create_automation | Create a bot, follower, emitter, or portfolio. | write:automation | write | POST /api/v1/bots |
start_automation | Start an owned automation. | write:lifecycle | write | POST /api/v1/bots/:id/start |
stop_automation | Stop an owned automation. | write:lifecycle | write | POST /api/v1/bots/:id/stop |
update_automation | Update a stopped automation (tags-only while running). | write:automation | write | PATCH /api/v1/bots/:id |
delete_automation | Delete an owned automation (requires confirm_delete). | write:automation | write | DELETE /api/v1/bots/:id |
set_automation_book | Set one bot/follower book leg (book-only or +venue). Session/MCP OAuth only. | write:lifecycle | write | POST /api/v1/bots/:id/books |
list_credentials | List exchange credentials (masked api_key only). | read:credentials | read | GET /api/v1/credentials |
create_credential | Create an exchange credential (secrets write-only). | write:credentials | write | POST /api/v1/credentials |
update_credential | Update credential name and/or rotate keys. | write:credentials | write | PUT /api/v1/credentials/:id |
set_default_credential | Mark a credential as default for its exchange. | write:credentials | write | POST /api/v1/credentials/:id/default |
delete_credential | Delete an exchange credential (requires confirm_delete). | write:credentials | write | DELETE /api/v1/credentials/:id |
list_tags | List automation tags. | read:automations | read | GET /api/v1/tags |
create_tag | Create an automation tag. | write:automation | write | POST /api/v1/tags |
update_tag | Update a tag lookup_key and/or description. | write:automation | write | PATCH /api/v1/tags/:id |
delete_tag | Delete a tag (requires confirm_delete). | write:automation | write | DELETE /api/v1/tags/:id |
create_ai_chat_conversation | Create an Ask AI conversation thread. | write:ask_ai | write | POST /api/v1/ai/chat/conversations |
ask_ai_chat | Send a message to Ask AI and wait for the full turn. | write:ask_ai | write | POST /api/v1/ai/chat/conversations/:id/messages |
confirm_ai_chat_tool | Approve or reject a pending Ask AI write tool. | write:ask_ai | write | POST /api/v1/ai/chat/conversations/:id/tools/:call_id/confirm |
get_ai_chat_conversation | Get an Ask AI conversation with messages. | write:ask_ai | write | GET /api/v1/ai/chat/conversations/:id |
list_ai_chat_conversations | List recent Ask AI conversations. | write:ask_ai | write | GET /api/v1/ai/chat/conversations |
get_ai_chat_quota | Daily Ask AI quota (used, limit, remaining). | write:ask_ai | write | GET /api/v1/ai/chat/quota |