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

​
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.

​
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

​
Tool Reference

​
Account & Portfolio

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

​
Order Execution

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

​
Limit & Batch Orders

​
tool
Get all active limit orders (limit buys, stop losses, take profits, trailing stops).
​
tool
Limit buy that triggers on price movement (pct_dip, pct_rise) or mcap.
​
tool
Sell when price drops or rises by a specified triggerPercent. Requires existing position.
​
tool
Tracks the highest price since creation. Sells when price drops X% from peak.
​
tool
Cancel an active limit order using orderId.
​
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 MCP networks, including 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).
​
REST
Create a new token pair. Requires Privy JWT auth. Body: accountId, chatId, label
​
REST
List all active tokens for the user.
​
REST
Revoke a single token or /all to revoke all tokens.
​
REST
Update spending limits on a write token.
​
REST
Set or remove webhook URL.