Developers

Reference

MCP tool directory

Generated from src/lib/tools.ts (58 listed tools). Catalog aliases (3000) are not hard-coded here — use search_catalog and run_tool. Example responses are not fabricated.

Future permission groups

Architecture reserved for per-tool access. Live MCP does not gate by group — every listed tool is public.

CORE DATA
MARKET INTELLIGENCE
TOKEN ANALYTICS
WALLET INTELLIGENCE
TRADING TOOLS
ADVANCED AGENT TOOLS

58 of 58 listed MCP tools. Catalog aliases (scan_NVDA, volume_1h, …) are invoked with search_catalog and run_tool — they are not duplicated here.

Token

search_token

TokenREAD ONLY

Search Robinhood Chain tokens, pools, and canonical Stock Tokens by ticker, name, or 0x address.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_token",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Ticker, name, or contract address"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/search_token?query=NVDA

scan_token

TokenREAD ONLY

OG-style Apogee scan: composite score, lookalike/ticker-collision flags, DEX vs RHJ premium, momentum, liquidity.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "scan_token",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Ticker or token address"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/scan_token?query=NVDA

get_token

TokenREAD ONLY

Full token intel: on-chain ERC-20 metadata plus every DexScreener market on Robinhood Chain.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_token",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Token address or ticker"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_token?address=0x%E2%80%A6

list_stock_tokens

TokenREAD ONLY

Canonical Robinhood Stock Token registry (contract, multiplier, logo) from RHJ /assets.

Required: none
Optional: query
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: RHJ registry cached ~10 minutes; DEX premium is read live from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_stock_tokens",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional ticker/name filter"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_stock_tokens

get_token_activity

TokenREAD ONLY

Recent buy/sell/burn transfers for a Robinhood Chain token from Blockscout tokentx plus DexScreener pairs.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_token_activity",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Token address or ticker"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_token_activity?query=NVDA

search_catalog

TokenREAD ONLY

Search all 3000 Robinhood Chain catalog operations by name or topic (wallet, analytics, pons, stocks).

Required: query
Optional: limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_catalog",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/search_catalog?query=NVDA

get_contract

TokenREAD ONLY

ERC-20 metadata and market count for a contract.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_contract",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_contract?address=0x%E2%80%A6

Market

get_chart

MarketREAD ONLY

OHLCV candles for the deepest Robinhood Chain pool of a token (GeckoTerminal).

Required: query
Optional: timeframe, aggregate, limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: GeckoTerminal OHLCV at request time. No local candle cache.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_chart",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Token, ticker, or pool address"
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "minute",
        "hour",
        "day"
      ],
      "default": "minute"
    },
    "aggregate": {
      "type": "number",
      "description": "Bar aggregation, e.g. 5 for 5m",
      "default": 5
    },
    "limit": {
      "type": "number",
      "description": "Candle count, max 1000",
      "default": 180
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_chart?query=NVDA

get_desk

MarketREAD ONLY

Trading desk snapshot: chain stats, trending pools, fresh launches, featured Stock Token oracle vs DEX.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: DexScreener / Gecko / DefiLlama at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_desk",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_desk

list_trending

MarketREAD ONLY

Trending Robinhood Chain pools right now.

Required: none
Optional: duration
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: DexScreener / Gecko / DefiLlama at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_trending",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "duration": {
      "type": "string",
      "enum": [
        "5m",
        "1h",
        "6h",
        "24h"
      ],
      "default": "1h"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_trending

list_top_pools

MarketREAD ONLY

Top Robinhood Chain pools by GeckoTerminal ranking.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_top_pools",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/list_top_pools

get_stock_quote

MarketREAD ONLY

Official RHJ bid/ask plus live Uniswap DEX price and premium/discount in bps for a Stock Token ticker.

Required: symbol
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: RHJ registry cached ~10 minutes; DEX premium is read live from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_stock_quote",
    "arguments": {
      "symbol": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Ticker e.g. NVDA"
    }
  },
  "required": [
    "symbol"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_stock_quote?symbol=NVDA

get_chain_stats

MarketREAD ONLY

Robinhood Chain height, gas, TVL, canonical USDG/WETH, Stock Token count.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_chain_stats",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_chain_stats

get_pair

MarketREAD ONLY

Details for a specific Robinhood Chain pool/pair address.

Required: pair
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pair",
    "arguments": {
      "pair": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string"
    }
  },
  "required": [
    "pair"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_pair?pair=0x%E2%80%A6

get_corporate_actions

MarketREAD ONLY

Processed Stock Token corporate actions (splits, dividends) from RHJ.

Required: none
Optional: limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: RHJ registry cached ~10 minutes; DEX premium is read live from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_corporate_actions",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/get_corporate_actions

list_boosted

MarketREAD ONLY

Latest DexScreener boosted tokens on Robinhood Chain.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: DexScreener / Gecko / DefiLlama at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_boosted",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/list_boosted

get_market_overview

MarketREAD ONLY

TVL, gas, and trending pools snapshot.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: DexScreener / Gecko / DefiLlama at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_market_overview",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_market_overview

Wallet

get_wallet

WalletREAD ONLY

Read-only ETH + USDG/WETH/major Stock Token balances for any 0x address. No key required.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet?address=0x%E2%80%A6

get_wallet_txs

WalletREAD ONLY

Explorer native + ERC-20 transfers for a Robinhood Chain wallet.

Required: address
Optional: page, offset
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_txs",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet_txs?address=0x%E2%80%A6

get_wallet_tokens

WalletREAD ONLY

ETH plus watched USDG/WETH/Stock Token balances for a wallet.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_tokens",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet_tokens?address=0x%E2%80%A6

get_wallet_pnl

WalletREAD ONLY

Mark-to-market wallet equity on Robinhood Chain using DexScreener USD prices.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_pnl",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet_pnl?address=0x%E2%80%A6

track_wallet

WalletREAD ONLY

Full wallet tracker: balances, PnL, recent flow. Read-only.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "track_wallet",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/track_wallet?address=0x%E2%80%A6

get_wallet_flow

WalletREAD ONLY

In/out transfer counts and counterparties for a wallet.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_flow",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet_flow?address=0x%E2%80%A6

get_service_wallet_status

WalletREAD ONLY

Public service wallet address, SOL/$ORBITX balances, memo/buy/burn totals. Never returns private keys.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_service_wallet_status",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_service_wallet_status

Trading

get_swap_quote

TradingREAD ONLY

Read-only indicative swap using live USD prices. Does not sign or broadcast.

Required: fromToken, toToken, amount
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_swap_quote",
    "arguments": {
      "fromToken": "ETH",
      "toToken": "USDG",
      "amount": "0.01"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "fromToken": {
      "type": "string"
    },
    "toToken": {
      "type": "string"
    },
    "amount": {
      "type": "string"
    }
  },
  "required": [
    "fromToken",
    "toToken",
    "amount"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_swap_quote?fromToken=ETH

get_gas_oracle

TradingREAD ONLY

Live gas price on Robinhood Chain.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_gas_oracle",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_gas_oracle

add_robinhood_chain

TradingLOW RISK ACTION

wallet_addEthereumChain params so Phantom or MetaMask can add Robinhood Chain (4663).

Required: none
Optional: none
Safety: Returns wallet_addEthereumChain parameters. The wallet, not Apogee, adds the network if the user confirms.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_robinhood_chain",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/add_robinhood_chain

Launch

list_launches

LaunchREAD ONLY

Newest Robinhood Chain launches. Prefers on-chain pons v2/v1 TokenLaunched events (bonding-curve + Uniswap) and also returns GeckoTerminal new pools.

Required: none
Optional: limit, lookback, generation
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: On-chain factory logs, cached ~20s in process memory.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_launches",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max pons launches to enrich (default 24)"
    },
    "lookback": {
      "type": "number",
      "description": "Block lookback for factory logs (default 8000)"
    },
    "generation": {
      "type": "string",
      "enum": [
        "all",
        "v1",
        "v2"
      ],
      "default": "all"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_launches

list_pons_launches

LaunchREAD ONLY

Index pons launches from factory TokenLaunched logs on Robinhood Chain. v2 is the live bonding-curve factory; v1 is Uniswap V3 vs WETH. Write pons lowercase.

Required: none
Optional: limit, lookback, generation
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: On-chain factory logs, cached ~20s in process memory.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_pons_launches",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "lookback": {
      "type": "number"
    },
    "generation": {
      "type": "string",
      "enum": [
        "all",
        "v1",
        "v2"
      ]
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_pons_launches

get_pons_token

LaunchREAD ONLY

Full on-chain pons launch record: metadata, socials, logo, factory tuple, curve reserves or V3 pool price, graduation progress, fee split. Resolve by token address.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pons_token",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Launch token 0x address"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_pons_token?address=0x%E2%80%A6

get_pons_graduation

LaunchREAD ONLY

Graduation progress for a pons token. v1: locked WETH principal vs threshold (default 4.2 ETH). v2: realQuoteReserve vs threshold / phase. Graduation is not a quality signal.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pons_graduation",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_pons_graduation?address=0x%E2%80%A6

get_pons_protocol

LaunchREAD ONLY

pons network facts, V1/V2 contracts, events, fee splits, reference PONS token, and attribution rules from docs.ponsfamily.com.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pons_protocol",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_pons_protocol

preview_pons_launch

LaunchREAD ONLY

Read pons v2 launch fee, economics pin, and factory status. Does not send a transaction.

Required: none
Optional: name, symbol, launchConfigId
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "preview_pons_launch",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "launchConfigId": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/preview_pons_launch

prepare_pons_launch

LaunchFINANCIAL / HIGH IMPACT

Build an unsigned pons v2 launchToken transaction for Phantom (ETH) on Robinhood Chain. User must sign. Apogee never holds keys.

Required: name, symbol
Optional: description, logo, twitter, telegram, website, creatorFeeRecipient, creatorTaxBps, buybackEnabled, launchConfigId
Safety: Returns an unsigned pons v2 launchToken transaction. Signing it in a wallet spends the launch fee in ETH. Apogee does not broadcast unless you sign.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "prepare_pons_launch",
    "arguments": {
      "name": "Example",
      "symbol": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "logo": {
      "type": "string"
    },
    "twitter": {
      "type": "string"
    },
    "telegram": {
      "type": "string"
    },
    "website": {
      "type": "string"
    },
    "creatorFeeRecipient": {
      "type": "string"
    },
    "creatorTaxBps": {
      "type": "number"
    },
    "buybackEnabled": {
      "type": "boolean"
    },
    "launchConfigId": {
      "type": "number"
    }
  },
  "required": [
    "name",
    "symbol"
  ]
}

REST GET https://apogeemcp.digital/api/v1/prepare_pons_launch?name=Example

prepare_pons_buy

LaunchFINANCIAL / HIGH IMPACT

Indicative pons buy helper plus the pons app URL. Does not broadcast.

Required: address
Optional: ethAmount
Safety: Indicative buy helper plus the pons app URL. Does not broadcast. Following the URL or signing a later tx can move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "prepare_pons_buy",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "ethAmount": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/prepare_pons_buy?address=0x%E2%80%A6

get_curve_quote

LaunchREAD ONLY

Bonding-curve / graduation state for a pons token.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_curve_quote",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_curve_quote?address=0x%E2%80%A6

Analytics

get_holders

AnalyticsREAD ONLY

Holder concentration proxy from recent explorer transfers plus DexScreener pool liquidity. Not a full ledger.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_holders",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_holders?address=0x%E2%80%A6

get_safety

AnalyticsREAD ONLY

Safety pass: canonical vs lookalike, liquidity, oracle tracking error. Same engine as scan_token.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_safety",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_safety?query=NVDA

verify_token

AnalyticsREAD ONLY

Anti-scam: confirm a ticker's canonical Stock Token contract and list colliding tickers on-chain.

Required: ticker
Optional: address
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "verify_token",
    "arguments": {
      "ticker": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "address": {
      "type": "string",
      "description": "Optional address to check against the canonical contract"
    }
  },
  "required": [
    "ticker"
  ]
}

REST GET https://apogeemcp.digital/api/v1/verify_token?ticker=NVDA

get_token_analytics

AnalyticsREAD ONLY

Volume, txns, liquidity, and change for a token over 5m/1h/6h/24h.

Required: query
Optional: window
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_token_analytics",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "window": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_token_analytics?query=NVDA

get_top_traders

AnalyticsREAD ONLY

Top flow wallets for a token from recent explorer transfers.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_top_traders",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_top_traders?query=NVDA

get_smart_money

AnalyticsREAD ONLY

Repeat-buy wallets in the recent transfer window (smart-money proxy).

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_smart_money",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_smart_money?query=NVDA

get_first_buyers

AnalyticsREAD ONLY

Earliest explorer token transfers for a Robinhood Chain token.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_first_buyers",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_first_buyers?query=NVDA

compare_tokens

AnalyticsREAD ONLY

Side-by-side analytics for two tickers or addresses.

Required: a, b
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compare_tokens",
    "arguments": {
      "a": "NVDA",
      "b": "AAPL"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string"
    },
    "b": {
      "type": "string"
    }
  },
  "required": [
    "a",
    "b"
  ]
}

REST GET https://apogeemcp.digital/api/v1/compare_tokens?a=NVDA

Utility

get_transaction

UtilityREAD ONLY

Fetch a transaction and receipt by hash from the public RPC.

Required: hash
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_transaction",
    "arguments": {
      "hash": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string"
    }
  },
  "required": [
    "hash"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_transaction?hash=0x%E2%80%A6

apogee_status

UtilityREAD ONLY

Health check for Apogee MCP. Reports 3000 catalog operations, chain stats, and the live MCP URL.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "apogee_status",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/apogee_status

run_tool

UtilityREAD ONLY

Invoke any of the 3000 catalog operations by exact name, including aliases like scan_NVDA or volume_1h.

Required: name
Optional: arguments
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run_tool",
    "arguments": {
      "name": "Example"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Catalog tool name"
    },
    "arguments": {
      "type": "object"
    }
  },
  "required": [
    "name"
  ]
}

REST GET https://apogeemcp.digital/api/v1/run_tool?name=Example

list_catalog_page

UtilityREAD ONLY

Page through the 3000-operation catalog.

Required: none
Optional: offset, limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_catalog_page",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_catalog_page

get_block

UtilityREAD ONLY

Fetch a block by number or latest.

Required: none
Optional: id
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_block",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/get_block

get_mcp_info

UtilityREAD ONLY

Canonical live MCP URL https://apogeemcp.digital/api/mcp and one-click install targets.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_mcp_info",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_mcp_info

write_onchain_note

UtilityFINANCIAL / HIGH IMPACT

Write a permanent Solana memo (ORBITX_NOTE:v1) via the Apogee service wallet, then buy and burn ~$0.03 of $ORBITX (keeping a $0.15 float). Public and irreversible. Rate limited. Returns signature + Solscan URL. Never send secrets.

Required: note
Optional: idempotencyKey, wallet
Safety: Broadcasts a public Solana memo from the Apogee service wallet and buys ~$0.03 of $ORBITX to burn, keeping a $0.15 float. Permanent. Rate limited. Do not put secrets in the note.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_onchain_note",
    "arguments": {
      "note": "UTF-8 note, max 240 characters. Permanent and public."
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string",
      "description": "UTF-8 note, max 240 characters. Permanent and public."
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Repeat the same key to avoid a second memo/burn."
    },
    "wallet": {
      "type": "string",
      "description": "Optional attribution address."
    }
  },
  "required": [
    "note"
  ]
}

REST GET https://apogeemcp.digital/api/v1/write_onchain_note?note=UTF-8%20note%2C%20max%20240%20characters.%20Permanent%20and%20public.

get_onchain_note

UtilityREAD ONLY

Fetch a verified on-chain note by Solana transaction signature.

Required: signature
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_onchain_note",
    "arguments": {
      "signature": "Solana transaction signature"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "signature": {
      "type": "string",
      "description": "Solana transaction signature"
    }
  },
  "required": [
    "signature"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_onchain_note?signature=Solana%20transaction%20signature

list_onchain_notes

UtilityREAD ONLY

List on-chain notes by reading confirmed Solana memos from the service wallet.

Required: none
Optional: wallet, search, limit, offset
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_onchain_notes",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "search": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_onchain_notes

get_onchain_activity

UtilityREAD ONLY

Public on-chain activity feed: memos, $ORBITX buys, and burns with Solscan links.

Required: none
Optional: eventType, limit, offset
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_onchain_activity",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "eventType": {
      "type": "string",
      "enum": [
        "ALL",
        "MEMOS",
        "BUYS",
        "BURNS",
        "MEMO_CREATED",
        "ORBITX_PURCHASE",
        "ORBITX_BURN"
      ]
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/get_onchain_activity

write_token_seal

UtilityFINANCIAL / HIGH IMPACT

Pick $ORBITX or $ROKHA, write a public memo, store an image forever, mint a 1/1, then buy/burn up to $0.25. Limited edition of 50 Saturn cards — after 50, writes are closed. Public and irreversible. Never send secrets. imageBase64 required.

Required: token, note, imageBase64
Optional: imageMime, usd, wallet
Safety: Stores an image forever, mints a 1/1, writes a public memo, and buys/burns up to $0.25 of $ORBITX or $ROKHA. Limited to 50 Saturn cards total. Rate limited. Do not put secrets in the note or image.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_token_seal",
    "arguments": {
      "token": "Token id, symbol, or mint. Supported: $ORBITX, $ROKHA.",
      "note": "UTF-8 memo, max 180 characters. Permanent and public.",
      "imageBase64": "JPEG/PNG/WebP as raw or data-URL base64."
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token id, symbol, or mint. Supported: $ORBITX, $ROKHA."
    },
    "note": {
      "type": "string",
      "description": "UTF-8 memo, max 180 characters. Permanent and public."
    },
    "imageBase64": {
      "type": "string",
      "description": "JPEG/PNG/WebP as raw or data-URL base64."
    },
    "imageMime": {
      "type": "string",
      "description": "image/jpeg, image/png, or image/webp."
    },
    "usd": {
      "type": "number",
      "description": "Burn size in USD, max 0.25."
    },
    "wallet": {
      "type": "string",
      "description": "Optional attribution address."
    }
  },
  "required": [
    "token",
    "note",
    "imageBase64"
  ]
}

REST GET https://apogeemcp.digital/api/v1/write_token_seal?token=Token%20id%2C%20symbol%2C%20or%20mint.%20Supported%3A%20%24ORBITX%2C%20%24ROKHA.

list_token_seals

UtilityREAD ONLY

List the limited-edition Apogee token seals (max 50 Saturn cards) with memo, image, buy/burn, and edition number.

Required: none
Optional: limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_token_seals",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_token_seals

list_burn_tokens

UtilityREAD ONLY

Supported tokens the service wallet can buy and burn on a token seal. Currently $ORBITX and $ROKHA, max $0.25 each.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_burn_tokens",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/list_burn_tokens

burn_orbitx

UtilityFINANCIAL / HIGH IMPACT

Admin-only: burn $ORBITX held by the service wallet. Requires adminSecret. Not a generic transaction signer.

Required: adminSecret
Optional: amount
Safety: Admin-only burn of $ORBITX held by the service wallet. Requires adminSecret. Not a generic signer.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "burn_orbitx",
    "arguments": {
      "adminSecret": "…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "adminSecret": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    }
  },
  "required": [
    "adminSecret"
  ]
}

REST GET https://apogeemcp.digital/api/v1/burn_orbitx?adminSecret=%E2%80%A6

Apogee provides software, data and developer infrastructure. Blockchain and market data can be incomplete, delayed or inaccurate. AI-generated output may contain errors. Nothing on the platform should be interpreted as financial, legal or investment advice.

Developers

MCP public·no roleProfile Support

Reference

MCP tool directory

Generated from src/lib/tools.ts (58 listed tools). Catalog aliases (3000) are not hard-coded here — use search_catalog and run_tool. Example responses are not fabricated.

Future permission groups

Architecture reserved for per-tool access. Live MCP does not gate by group — every listed tool is public.

CORE DATA
MARKET INTELLIGENCE
TOKEN ANALYTICS
WALLET INTELLIGENCE
TRADING TOOLS
ADVANCED AGENT TOOLS

58 of 58 listed MCP tools. Catalog aliases (scan_NVDA, volume_1h, …) are invoked with search_catalog and run_tool — they are not duplicated here.

Token

search_token

TokenREAD ONLY

Search Robinhood Chain tokens, pools, and canonical Stock Tokens by ticker, name, or 0x address.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_token",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Ticker, name, or contract address"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/search_token?query=NVDA

scan_token

TokenREAD ONLY

OG-style Apogee scan: composite score, lookalike/ticker-collision flags, DEX vs RHJ premium, momentum, liquidity.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "scan_token",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Ticker or token address"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/scan_token?query=NVDA

get_token

TokenREAD ONLY

Full token intel: on-chain ERC-20 metadata plus every DexScreener market on Robinhood Chain.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_token",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Token address or ticker"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_token?address=0x%E2%80%A6

list_stock_tokens

TokenREAD ONLY

Canonical Robinhood Stock Token registry (contract, multiplier, logo) from RHJ /assets.

Required: none
Optional: query
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: RHJ registry cached ~10 minutes; DEX premium is read live from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_stock_tokens",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional ticker/name filter"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_stock_tokens

get_token_activity

TokenREAD ONLY

Recent buy/sell/burn transfers for a Robinhood Chain token from Blockscout tokentx plus DexScreener pairs.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_token_activity",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Token address or ticker"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_token_activity?query=NVDA

search_catalog

TokenREAD ONLY

Search all 3000 Robinhood Chain catalog operations by name or topic (wallet, analytics, pons, stocks).

Required: query
Optional: limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_catalog",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/search_catalog?query=NVDA

get_contract

TokenREAD ONLY

ERC-20 metadata and market count for a contract.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_contract",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_contract?address=0x%E2%80%A6

Market

get_chart

MarketREAD ONLY

OHLCV candles for the deepest Robinhood Chain pool of a token (GeckoTerminal).

Required: query
Optional: timeframe, aggregate, limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: GeckoTerminal OHLCV at request time. No local candle cache.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_chart",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Token, ticker, or pool address"
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "minute",
        "hour",
        "day"
      ],
      "default": "minute"
    },
    "aggregate": {
      "type": "number",
      "description": "Bar aggregation, e.g. 5 for 5m",
      "default": 5
    },
    "limit": {
      "type": "number",
      "description": "Candle count, max 1000",
      "default": 180
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_chart?query=NVDA

get_desk

MarketREAD ONLY

Trading desk snapshot: chain stats, trending pools, fresh launches, featured Stock Token oracle vs DEX.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: DexScreener / Gecko / DefiLlama at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_desk",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_desk

list_trending

MarketREAD ONLY

Trending Robinhood Chain pools right now.

Required: none
Optional: duration
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: DexScreener / Gecko / DefiLlama at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_trending",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "duration": {
      "type": "string",
      "enum": [
        "5m",
        "1h",
        "6h",
        "24h"
      ],
      "default": "1h"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_trending

list_top_pools

MarketREAD ONLY

Top Robinhood Chain pools by GeckoTerminal ranking.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_top_pools",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/list_top_pools

get_stock_quote

MarketREAD ONLY

Official RHJ bid/ask plus live Uniswap DEX price and premium/discount in bps for a Stock Token ticker.

Required: symbol
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: RHJ registry cached ~10 minutes; DEX premium is read live from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_stock_quote",
    "arguments": {
      "symbol": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Ticker e.g. NVDA"
    }
  },
  "required": [
    "symbol"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_stock_quote?symbol=NVDA

get_chain_stats

MarketREAD ONLY

Robinhood Chain height, gas, TVL, canonical USDG/WETH, Stock Token count.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_chain_stats",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_chain_stats

get_pair

MarketREAD ONLY

Details for a specific Robinhood Chain pool/pair address.

Required: pair
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pair",
    "arguments": {
      "pair": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string"
    }
  },
  "required": [
    "pair"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_pair?pair=0x%E2%80%A6

get_corporate_actions

MarketREAD ONLY

Processed Stock Token corporate actions (splits, dividends) from RHJ.

Required: none
Optional: limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: RHJ registry cached ~10 minutes; DEX premium is read live from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_corporate_actions",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/get_corporate_actions

list_boosted

MarketREAD ONLY

Latest DexScreener boosted tokens on Robinhood Chain.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: DexScreener / Gecko / DefiLlama at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_boosted",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/list_boosted

get_market_overview

MarketREAD ONLY

TVL, gas, and trending pools snapshot.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: DexScreener / Gecko / DefiLlama at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_market_overview",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_market_overview

Wallet

get_wallet

WalletREAD ONLY

Read-only ETH + USDG/WETH/major Stock Token balances for any 0x address. No key required.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet?address=0x%E2%80%A6

get_wallet_txs

WalletREAD ONLY

Explorer native + ERC-20 transfers for a Robinhood Chain wallet.

Required: address
Optional: page, offset
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_txs",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet_txs?address=0x%E2%80%A6

get_wallet_tokens

WalletREAD ONLY

ETH plus watched USDG/WETH/Stock Token balances for a wallet.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_tokens",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet_tokens?address=0x%E2%80%A6

get_wallet_pnl

WalletREAD ONLY

Mark-to-market wallet equity on Robinhood Chain using DexScreener USD prices.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_pnl",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet_pnl?address=0x%E2%80%A6

track_wallet

WalletREAD ONLY

Full wallet tracker: balances, PnL, recent flow. Read-only.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "track_wallet",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/track_wallet?address=0x%E2%80%A6

get_wallet_flow

WalletREAD ONLY

In/out transfer counts and counterparties for a wallet.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Balances from public RPC at request time; USD marks from DexScreener.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_flow",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_wallet_flow?address=0x%E2%80%A6

get_service_wallet_status

WalletREAD ONLY

Public service wallet address, SOL/$ORBITX balances, memo/buy/burn totals. Never returns private keys.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_service_wallet_status",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_service_wallet_status

Trading

get_swap_quote

TradingREAD ONLY

Read-only indicative swap using live USD prices. Does not sign or broadcast.

Required: fromToken, toToken, amount
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_swap_quote",
    "arguments": {
      "fromToken": "ETH",
      "toToken": "USDG",
      "amount": "0.01"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "fromToken": {
      "type": "string"
    },
    "toToken": {
      "type": "string"
    },
    "amount": {
      "type": "string"
    }
  },
  "required": [
    "fromToken",
    "toToken",
    "amount"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_swap_quote?fromToken=ETH

get_gas_oracle

TradingREAD ONLY

Live gas price on Robinhood Chain.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_gas_oracle",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_gas_oracle

add_robinhood_chain

TradingLOW RISK ACTION

wallet_addEthereumChain params so Phantom or MetaMask can add Robinhood Chain (4663).

Required: none
Optional: none
Safety: Returns wallet_addEthereumChain parameters. The wallet, not Apogee, adds the network if the user confirms.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_robinhood_chain",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/add_robinhood_chain

Launch

list_launches

LaunchREAD ONLY

Newest Robinhood Chain launches. Prefers on-chain pons v2/v1 TokenLaunched events (bonding-curve + Uniswap) and also returns GeckoTerminal new pools.

Required: none
Optional: limit, lookback, generation
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: On-chain factory logs, cached ~20s in process memory.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_launches",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max pons launches to enrich (default 24)"
    },
    "lookback": {
      "type": "number",
      "description": "Block lookback for factory logs (default 8000)"
    },
    "generation": {
      "type": "string",
      "enum": [
        "all",
        "v1",
        "v2"
      ],
      "default": "all"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_launches

list_pons_launches

LaunchREAD ONLY

Index pons launches from factory TokenLaunched logs on Robinhood Chain. v2 is the live bonding-curve factory; v1 is Uniswap V3 vs WETH. Write pons lowercase.

Required: none
Optional: limit, lookback, generation
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: On-chain factory logs, cached ~20s in process memory.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_pons_launches",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "lookback": {
      "type": "number"
    },
    "generation": {
      "type": "string",
      "enum": [
        "all",
        "v1",
        "v2"
      ]
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_pons_launches

get_pons_token

LaunchREAD ONLY

Full on-chain pons launch record: metadata, socials, logo, factory tuple, curve reserves or V3 pool price, graduation progress, fee split. Resolve by token address.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pons_token",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Launch token 0x address"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_pons_token?address=0x%E2%80%A6

get_pons_graduation

LaunchREAD ONLY

Graduation progress for a pons token. v1: locked WETH principal vs threshold (default 4.2 ETH). v2: realQuoteReserve vs threshold / phase. Graduation is not a quality signal.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pons_graduation",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_pons_graduation?address=0x%E2%80%A6

get_pons_protocol

LaunchREAD ONLY

pons network facts, V1/V2 contracts, events, fee splits, reference PONS token, and attribution rules from docs.ponsfamily.com.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_pons_protocol",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_pons_protocol

preview_pons_launch

LaunchREAD ONLY

Read pons v2 launch fee, economics pin, and factory status. Does not send a transaction.

Required: none
Optional: name, symbol, launchConfigId
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "preview_pons_launch",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "launchConfigId": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/preview_pons_launch

prepare_pons_launch

LaunchFINANCIAL / HIGH IMPACT

Build an unsigned pons v2 launchToken transaction for Phantom (ETH) on Robinhood Chain. User must sign. Apogee never holds keys.

Required: name, symbol
Optional: description, logo, twitter, telegram, website, creatorFeeRecipient, creatorTaxBps, buybackEnabled, launchConfigId
Safety: Returns an unsigned pons v2 launchToken transaction. Signing it in a wallet spends the launch fee in ETH. Apogee does not broadcast unless you sign.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "prepare_pons_launch",
    "arguments": {
      "name": "Example",
      "symbol": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "logo": {
      "type": "string"
    },
    "twitter": {
      "type": "string"
    },
    "telegram": {
      "type": "string"
    },
    "website": {
      "type": "string"
    },
    "creatorFeeRecipient": {
      "type": "string"
    },
    "creatorTaxBps": {
      "type": "number"
    },
    "buybackEnabled": {
      "type": "boolean"
    },
    "launchConfigId": {
      "type": "number"
    }
  },
  "required": [
    "name",
    "symbol"
  ]
}

REST GET https://apogeemcp.digital/api/v1/prepare_pons_launch?name=Example

prepare_pons_buy

LaunchFINANCIAL / HIGH IMPACT

Indicative pons buy helper plus the pons app URL. Does not broadcast.

Required: address
Optional: ethAmount
Safety: Indicative buy helper plus the pons app URL. Does not broadcast. Following the URL or signing a later tx can move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "prepare_pons_buy",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "ethAmount": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/prepare_pons_buy?address=0x%E2%80%A6

get_curve_quote

LaunchREAD ONLY

Bonding-curve / graduation state for a pons token.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_curve_quote",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_curve_quote?address=0x%E2%80%A6

Analytics

get_holders

AnalyticsREAD ONLY

Holder concentration proxy from recent explorer transfers plus DexScreener pool liquidity. Not a full ledger.

Required: address
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_holders",
    "arguments": {
      "address": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_holders?address=0x%E2%80%A6

get_safety

AnalyticsREAD ONLY

Safety pass: canonical vs lookalike, liquidity, oracle tracking error. Same engine as scan_token.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_safety",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_safety?query=NVDA

verify_token

AnalyticsREAD ONLY

Anti-scam: confirm a ticker's canonical Stock Token contract and list colliding tickers on-chain.

Required: ticker
Optional: address
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "verify_token",
    "arguments": {
      "ticker": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "address": {
      "type": "string",
      "description": "Optional address to check against the canonical contract"
    }
  },
  "required": [
    "ticker"
  ]
}

REST GET https://apogeemcp.digital/api/v1/verify_token?ticker=NVDA

get_token_analytics

AnalyticsREAD ONLY

Volume, txns, liquidity, and change for a token over 5m/1h/6h/24h.

Required: query
Optional: window
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_token_analytics",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "window": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_token_analytics?query=NVDA

get_top_traders

AnalyticsREAD ONLY

Top flow wallets for a token from recent explorer transfers.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_top_traders",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_top_traders?query=NVDA

get_smart_money

AnalyticsREAD ONLY

Repeat-buy wallets in the recent transfer window (smart-money proxy).

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_smart_money",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_smart_money?query=NVDA

get_first_buyers

AnalyticsREAD ONLY

Earliest explorer token transfers for a Robinhood Chain token.

Required: query
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_first_buyers",
    "arguments": {
      "query": "NVDA"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_first_buyers?query=NVDA

compare_tokens

AnalyticsREAD ONLY

Side-by-side analytics for two tickers or addresses.

Required: a, b
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compare_tokens",
    "arguments": {
      "a": "NVDA",
      "b": "AAPL"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string"
    },
    "b": {
      "type": "string"
    }
  },
  "required": [
    "a",
    "b"
  ]
}

REST GET https://apogeemcp.digital/api/v1/compare_tokens?a=NVDA

Utility

get_transaction

UtilityREAD ONLY

Fetch a transaction and receipt by hash from the public RPC.

Required: hash
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_transaction",
    "arguments": {
      "hash": "0x…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "hash": {
      "type": "string"
    }
  },
  "required": [
    "hash"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_transaction?hash=0x%E2%80%A6

apogee_status

UtilityREAD ONLY

Health check for Apogee MCP. Reports 3000 catalog operations, chain stats, and the live MCP URL.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "apogee_status",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/apogee_status

run_tool

UtilityREAD ONLY

Invoke any of the 3000 catalog operations by exact name, including aliases like scan_NVDA or volume_1h.

Required: name
Optional: arguments
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run_tool",
    "arguments": {
      "name": "Example"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Catalog tool name"
    },
    "arguments": {
      "type": "object"
    }
  },
  "required": [
    "name"
  ]
}

REST GET https://apogeemcp.digital/api/v1/run_tool?name=Example

list_catalog_page

UtilityREAD ONLY

Page through the 3000-operation catalog.

Required: none
Optional: offset, limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_catalog_page",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_catalog_page

get_block

UtilityREAD ONLY

Fetch a block by number or latest.

Required: none
Optional: id
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_block",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/get_block

get_mcp_info

UtilityREAD ONLY

Canonical live MCP URL https://apogeemcp.digital/api/mcp and one-click install targets.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Live RPC / provider calls at request time.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_mcp_info",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/get_mcp_info

write_onchain_note

UtilityFINANCIAL / HIGH IMPACT

Required: note
Optional: idempotencyKey, wallet
Safety: Broadcasts a public Solana memo from the Apogee service wallet and buys ~$0.03 of $ORBITX to burn, keeping a $0.15 float. Permanent. Rate limited. Do not put secrets in the note.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_onchain_note",
    "arguments": {
      "note": "UTF-8 note, max 240 characters. Permanent and public."
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "note": {
      "type": "string",
      "description": "UTF-8 note, max 240 characters. Permanent and public."
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Repeat the same key to avoid a second memo/burn."
    },
    "wallet": {
      "type": "string",
      "description": "Optional attribution address."
    }
  },
  "required": [
    "note"
  ]
}

REST GET https://apogeemcp.digital/api/v1/write_onchain_note?note=UTF-8%20note%2C%20max%20240%20characters.%20Permanent%20and%20public.

get_onchain_note

UtilityREAD ONLY

Fetch a verified on-chain note by Solana transaction signature.

Required: signature
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_onchain_note",
    "arguments": {
      "signature": "Solana transaction signature"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "signature": {
      "type": "string",
      "description": "Solana transaction signature"
    }
  },
  "required": [
    "signature"
  ]
}

REST GET https://apogeemcp.digital/api/v1/get_onchain_note?signature=Solana%20transaction%20signature

list_onchain_notes

UtilityREAD ONLY

List on-chain notes by reading confirmed Solana memos from the service wallet.

Required: none
Optional: wallet, search, limit, offset
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_onchain_notes",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "search": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_onchain_notes

get_onchain_activity

UtilityREAD ONLY

Public on-chain activity feed: memos, $ORBITX buys, and burns with Solscan links.

Required: none
Optional: eventType, limit, offset
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_onchain_activity",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "eventType": {
      "type": "string",
      "enum": [
        "ALL",
        "MEMOS",
        "BUYS",
        "BURNS",
        "MEMO_CREATED",
        "ORBITX_PURCHASE",
        "ORBITX_BURN"
      ]
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/get_onchain_activity

write_token_seal

UtilityFINANCIAL / HIGH IMPACT

Required: token, note, imageBase64
Optional: imageMime, usd, wallet
Safety: Stores an image forever, mints a 1/1, writes a public memo, and buys/burns up to $0.25 of $ORBITX or $ROKHA. Limited to 50 Saturn cards total. Rate limited. Do not put secrets in the note or image.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_token_seal",
    "arguments": {
      "token": "Token id, symbol, or mint. Supported: $ORBITX, $ROKHA.",
      "note": "UTF-8 memo, max 180 characters. Permanent and public.",
      "imageBase64": "JPEG/PNG/WebP as raw or data-URL base64."
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token id, symbol, or mint. Supported: $ORBITX, $ROKHA."
    },
    "note": {
      "type": "string",
      "description": "UTF-8 memo, max 180 characters. Permanent and public."
    },
    "imageBase64": {
      "type": "string",
      "description": "JPEG/PNG/WebP as raw or data-URL base64."
    },
    "imageMime": {
      "type": "string",
      "description": "image/jpeg, image/png, or image/webp."
    },
    "usd": {
      "type": "number",
      "description": "Burn size in USD, max 0.25."
    },
    "wallet": {
      "type": "string",
      "description": "Optional attribution address."
    }
  },
  "required": [
    "token",
    "note",
    "imageBase64"
  ]
}

REST GET https://apogeemcp.digital/api/v1/write_token_seal?token=Token%20id%2C%20symbol%2C%20or%20mint.%20Supported%3A%20%24ORBITX%2C%20%24ROKHA.

list_token_seals

UtilityREAD ONLY

List the limited-edition Apogee token seals (max 50 Saturn cards) with memo, image, buy/burn, and edition number.

Required: none
Optional: limit
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_token_seals",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    }
  }
}

REST GET https://apogeemcp.digital/api/v1/list_token_seals

list_burn_tokens

UtilityREAD ONLY

Supported tokens the service wallet can buy and burn on a token seal. Currently $ORBITX and $ROKHA, max $0.25 each.

Required: none
Optional: none
Safety: Retrieves public chain or market data. Does not sign, broadcast, or move funds.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Unknown tool → HTTP 404 / Unknown tool. Missing or unresolvable arguments → { ok: false, error }. Upstream provider failures surface as error strings.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_burn_tokens",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {}
}

REST GET https://apogeemcp.digital/api/v1/list_burn_tokens

burn_orbitx

UtilityFINANCIAL / HIGH IMPACT

Admin-only: burn $ORBITX held by the service wallet. Requires adminSecret. Not a generic transaction signer.

Required: adminSecret
Optional: amount
Safety: Admin-only burn of $ORBITX held by the service wallet. Requires adminSecret. Not a generic signer.
Freshness: Provider or chain read at request time unless noted. Do not cache indefinitely.
Permissions / rate limits: Auth none. Every listed tool is callable without credentials. High-impact helpers still require a local wallet signature to take effect. 180 HTTP requests / 60 seconds / client IP / process.
Output: No JSON Schema output is published. Successful MCP calls return JSON as structuredContent (and a text copy). Failures use { ok: false, error } or MCP isError. Sample numbers are not fabricated here — call the live tool.
Errors: Same as read-only tools, plus: signing/broadcast is never performed by the server. A prepared payload is not a confirmed transaction.

Example MCP request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "burn_orbitx",
    "arguments": {
      "adminSecret": "…"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "adminSecret": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    }
  },
  "required": [
    "adminSecret"
  ]
}

REST GET https://apogeemcp.digital/api/v1/burn_orbitx?adminSecret=%E2%80%A6