Skip to main content
The cove-trading MCP Server allows AI agents to execute trades, manage limits, and query token analytics directly through the Cove infrastructure.
Server Version: v0.1.0
Endpoint: POST /mcp
Transport: Streamable HTTP (SSE)

​
Quick Start

It’s incredibly easy to get your agent connected to Cove’s MCP server:
  1. Get Credentials: Run the /agent command in the Cove Telegram Bot to generate your unique read-write token pair and endpoint URL.
  2. Configure your Agent: Provide the URL and headers to your agent’s configuration.
  3. Start Exploring: Instruct your agent to explore all available tools on the Cove MCP server.
Cove’s MCP server works seamlessly with tools like mcporter, which is the standard used by frameworks like OpenClaw to connect agents to MCP servers.

​
Authentication & Tokens

Each account gets a token pair when created via /agent in Telegram or POST /agent/tokens:
  • Read-only token (permission: "read") — can call all read tools. Cannot execute trades.
  • Read-write token (permission: "readwrite") — full access including order execution, limit orders, and cancellations.
Tokens are shown once at creation. Creating new tokens for an account automatically revokes the previous pair.

​
MCP Config Example

{
  "cove-trading": {
    "url": "https://your-endpoint/api/mcp",
    "headers": {
      "Authorization": "Bearer <your-read-write-token>"
    }
  }
}

​
Permissions & Limits

Write tools return an error when called with a read-only token.

Write Tools

buy_token, sell_token, create_limit_buy, create_stop_loss, create_take_profit, create_trailing_stop, cancel_limit_order, simulate_swap, batch_order

Read Tools

All other tools like get_balance, get_positions, search_tokens, analytics, etc.

​
Spending Limits

Configurable per write token via Telegram /agent or PATCH /agent/tokens/:id/limits. Only buy operations are gated — sells and protection parameters are never blocked so users can always exit positions.
LimitDescription
maxPerTradeUsdMaximum USD per single buy order
maxHourlyUsdMaximum USD spent on buys in a rolling 1-hour window
maxDailyUsdMaximum USD spent on buys in a rolling 24-hour window

​
Webhook Callbacks

Optional webhook callback (set via Telegram /agent or PATCH /agent/tokens/:id/webhook). Delivers POST events for:
  • order_filled
  • order_failed
  • trade_reconciled
{
  "event": "order_filled",
  "orderId": "01JQXYZ...",
  "status": "success",
  "tokenSymbol": "BONK",
  "tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "chainId": 1399811149,
  "side": "buy",
  "amountUsd": "100.00",
  "tokenAmount": "1234567.89",
  "priceUsd": "0.000081",
  "txHashes": ["5k2F..."],
  "timestamp": "2026-03-26T18:30:00.000Z"
}

​
Tool Reference

​
Account & Portfolio

​
get_balance
tool
Get the available USDC balance (in USD) for trading.
​
get_positions
tool
Get all open token positions with PnL for the connected account.
​
get_trading_history
tool
Get recent order history. Parameters: limit (default: 20), status filter.
​
get_order_status
tool
Check a specific order by ID. Requires orderId.

​
Order Execution

​
buy_token
tool
Buy a token with USDC. Requires tokenAddress, chainId, amountUsd.
​
sell_token
tool
Sell a token position for USDC. Requires tokenAddress, chainId, and either percent or amountUsd.
​
simulate_swap
tool
Preview a swap without executing. Returns routing, output estimate, price impact, fees.

​
Limit & Batch Orders

​
get_limit_orders
tool
Get all active limit orders (limit buys, stop losses, take profits, trailing stops).
​
create_limit_buy
tool
Limit buy that triggers on price movement (pct_dip, pct_rise) or mcap.
​
create_stop_loss / create_take_profit
tool
Sell when price drops or rises by a specified triggerPercent. Requires existing position.
​
create_trailing_stop
tool
Tracks the highest price since creation. Sells when price drops X% from peak.
​
cancel_limit_order
tool
Cancel an active limit order using orderId.
​
batch_order
tool
Buy a token and set stop-loss and/or take-profit in one call. If buy fails, nothing is created.

​
Token Info & Market Scanning

You can search and fetch data across supported chains like Solana (1399811149), Base (8453), Ethereum (1), and BNB Chain (56).
  • search_tokens: Search by query (name/symbol).
  • get_token_info: Basic info by contract address.
  • get_pump_bonding_curve: Check launchpad/bonding curve status.
  • get_token_security_report: Comprehensive security report including scam flag, mint/freeze authority, locks.
  • scan_trending_tokens: Scan trending tokens on a specific network.
  • scan_new_tokens: Find newly created tokens with minimum liquidity.
  • scan_top_volume_tokens: Scan tokens sorted by highest volume.
  • get_token_stats: Comprehensive stats (price, volume, holders, flags, DEX pools).
  • get_price_history: OHLCV candles for technical analysis.
  • get_recent_trades: Recent swap events (buys/sells with prices).
  • get_token_holders, get_top_holders_pct, get_token_top_traders: Holder & trader analytics.
  • get_pair_stats, get_token_pairs: DEX pool and pair statistics.
  • get_liquidity_locks: Check liquidity lock status.

​
Wallet Analytics

Evaluate the performance and trading activity of individual wallets.

Wallet Stats

get_wallet_stats to verify PnL, win rate, and bot/scammer scores.

Wallet Trades

get_wallet_trades to fetch recent trades by a specific wallet.

Bulk Analysis

analyze_wallets to compare up to 50 addresses by PnL or win rate.

Find Alpha

find_smart_wallets to discover the most profitable non-bot traders.

​
REST API — Token Management

Used to manage agent tokens programmatically (not via MCP).
​
POST /agent/tokens
REST
Create a new token pair. Requires Privy JWT auth. Body: accountId, chatId, label
​
GET /agent/tokens
REST
List all active tokens for the user.
​
DELETE /agent/tokens/:id
REST
Revoke a single token or /all to revoke all tokens.
​
PATCH /agent/tokens/:id/limits
REST
Update spending limits on a write token.
​
PATCH /agent/tokens/:id/webhook
REST
Set or remove webhook URL.