agentsapi-top MCP API
Model Context Protocol (JSON-RPC 2.0 over HTTP) endpoint — 7 paid tools with an anonymous free tier
Model Context Protocol (JSON-RPC 2.0 over HTTP) endpoint — 7 paid tools with an anonymous free tier
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/agentsapi-top:agentsapi-top-mcp-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: bridge-watch MCP API
version: 0.1.0
description: 'On-chain risk intelligence API for AI agents on Base: address labels, transaction explain, sybil clustering, CCTP tracking, alerts. Pay per request with USDC via x402 (HTTP 402 auto-negotiated).'
x-guidance: 'All /v1/* endpoints are paid via x402: call without auth, read the 402/401 response body for the PaymentRequired challenge, pay with USDC on Base (eip155:8453) to payTo 0x381cdbb664608bf7b1dd4f9403a572c1c57332c2, then retry with X-Payment header or Authorization: Bearer <payment-address>. /healthz and /statusz are free. See /.well-known/x402 for the full manifest.'
contact:
name: mavisCrypto
url: https://agentsapi.top
email: ops@agentsapi.top
x-version:
restSpec: 0.1.0
product: 0.3.1
mcpServer: 0.3.1
note: restSpec is the version of this OpenAPI document; product/mcpServer are the live bridge-watch release, sourced from GET /mcp and MCP initialize at build time
source:
- GET https://agentsapi.top/mcp
- POST https://agentsapi.top/mcp initialize
- POST https://agentsapi.top/mcp tools/list
x-mcp:
endpoint: https://agentsapi.top/mcp
transport: streamable-http
registry: top.agentsapi/bridge-watch
serverInfo:
name: bridge-watch
version: 0.3.1
protocolVersion: '2025-06-18'
freeTier:
enabled: true
tools:
- get_label
- explain_transaction
- detect_cluster
- query_alerts
- alert_stats
- track_cctp
- list_paid_endpoints
perIp: 7
dailyCap: 500
perTool: 1
tools:
- name: get_label
credits: 1
usdc: '0.01'
description: Look up the identity label of an EVM address (Base, open eth-labels dataset; mostly category tags rather than named entities). Returns which entity the address belongs to; unlabelled addresses return null. Call with no arguments for a free demo result.
readOnly: true
- name: explain_transaction
credits: 2
usdc: '0.02'
description: 'Explain what a transaction did: status, sender/receiver (with identity labels), transfer details, and whether it looks like a cross-chain bridge operation.'
readOnly: true
- name: detect_cluster
credits: 5
usdc: '0.05'
description: Detect the set of addresses funded by a single funder (shared funding-source cluster). Useful for sybil / entity detection.
readOnly: true
- name: query_alerts
credits: 1
usdc: '0.01'
description: Query historical alert records; filterable by address, rule kind, severity, and time range.
readOnly: true
- name: alert_stats
credits: 1
usdc: '0.01'
description: 'Alert statistics overview: totals, breakdown by kind / severity / address, and the latest alert time.'
readOnly: true
- name: track_cctp
credits: 3
usdc: '0.03'
description: 'CCTP cross-chain transfer tracking: given a source-chain tx hash, find which transfer it belongs to, how much moved, the destination chain, and whether it arrived. Supports Base → Ethereum and other CCTP chains.'
readOnly: true
- name: list_paid_endpoints
credits: 1
usdc: '0.01'
description: List every paid HTTP endpoint of this service with its live per-call price in USDC on Base. Takes no arguments. Call this first to discover what you can buy and what it costs.
readOnly: true
payment:
protocol: x402 v2 (v1 X-PAYMENT compatible)
network: base
payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
asset: USDC
creditPerUsdc: 100
howToCall:
- 'POST https://agentsapi.top/mcp with Content-Type: application/json and Accept: application/json, text/event-stream'
- 'Body is JSON-RPC 2.0: initialize (free) → tools/list (free) → tools/call (paid)'
- A paid tool/call returns a PaymentRequired object inside the JSON-RPC result; the /mcp protocol plane itself never returns HTTP 402
- 'Pay USDC on Base to payTo, then retry tools/call with the payer address as Authorization: Bearer <address> (or x402 payment-signature header)'
- 'Anonymous free tier: 7 tool calls per IP per day, 1 per tool across all 7 tools (get_label, explain_transaction, detect_cluster, query_alerts, alert_stats, track_cctp, list_paid_endpoints; no wallet, no signup)'
machineReadable:
mcpDescriptor: https://agentsapi.top/.well-known/mcp.json
serverCard: https://agentsapi.top/.well-known/mcp/server-card.json
x402Manifest: https://agentsapi.top/.well-known/x402
skill: https://agentsapi.top/skill.md
llmsTxt: https://agentsapi.top/llms.txt
servers:
- url: https://agentsapi.top
tags:
- name: MCP
description: Model Context Protocol (JSON-RPC 2.0 over HTTP) endpoint — 7 paid tools with an anonymous free tier
paths:
/mcp:
post:
tags:
- MCP
summary: MCP JSON-RPC 2.0 endpoint (7 tools, x402 metered)
description: 'Streamable-HTTP MCP endpoint. Protocol methods initialize / tools/list / ping are free; tools/call is metered in USDC on Base via x402. The protocol plane answers HTTP 200 — a payment requirement is delivered as a PaymentRequired object inside the JSON-RPC result, not as HTTP 402. Anonymous callers get 7 free tool calls per IP per day, 1 per tool, covering all 7 tools: get_label, explain_transaction, detect_cluster, query_alerts, alert_stats, track_cctp, list_paid_endpoints.'
operationId: mcpRpc
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
oneOf:
- type: string
- type: number
method:
type: string
enum:
- initialize
- tools/list
- tools/call
- ping
params:
type: object
properties:
name:
type: string
enum:
- get_label
- explain_transaction
- detect_cluster
- query_alerts
- alert_stats
- track_cctp
- list_paid_endpoints
description: Tool name, required for tools/call
arguments:
type: object
additionalProperties: true
protocolVersion:
type: string
capabilities:
type: object
clientInfo:
type: object
examples:
toolsList:
value:
jsonrpc: '2.0'
id: 2
method: tools/list
params: {}
toolCall:
value:
jsonrpc: '2.0'
id: 3
method: tools/call
params:
name: get_label
arguments: {}
responses:
'200':
description: JSON-RPC 2.0 response (application/json or text/event-stream)
content:
application/json:
schema:
type: object
example:
jsonrpc: '2.0'
id: 2
result:
tools:
- name: get_label
description: Look up the identity label of an EVM address (Base, open eth-labels dataset; mostly category tags rather than named entities). Returns which entity the address belongs to; unlabelled addresses return null. Call with no arguments for a free demo result.
- name: explain_transaction
description: 'Explain what a transaction did: status, sender/receiver (with identity labels), transfer details, and whether it looks like a cross-chain bridge operation.'
- name: detect_cluster
description: Detect the set of addresses funded by a single funder (shared funding-source cluster). Useful for sybil / entity detection.
- name: query_alerts
description: Query historical alert records; filterable by address, rule kind, severity, and time range.
- name: alert_stats
description: 'Alert statistics overview: totals, breakdown by kind / severity / address, and the latest alert time.'
- name: track_cctp
description: 'CCTP cross-chain transfer tracking: given a source-chain tx hash, find which transfer it belongs to, how much moved, the destination chain, and whether it arrived. Supports Base → Ethereum and other CCTP chains.'
- name: list_paid_endpoints
description: List every paid HTTP endpoint of this service with its live per-call price in USDC on Base. Takes no arguments. Call this first to discover what you can buy and what it costs.
x-x402:
payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
network: eip155:8453
asset: USDC
creditPerUsdc: 100
perToolUsdc:
get_label: '0.01'
explain_transaction: '0.02'
detect_cluster: '0.05'
query_alerts: '0.01'
alert_stats: '0.01'
track_cctp: '0.03'
list_paid_endpoints: '0.01'
protocolPlaneStatus: never 402
get:
tags:
- MCP
summary: Open the MCP SSE stream, or fetch the machine-readable endpoint card
description: 'With Accept: text/event-stream this opens the MCP SSE stream (spec-compliant clients). With Accept: application/json it returns the machine-readable endpoint card listing all 7 tools with live per-call USDC prices. Both are free and unauthenticated.'
operationId: mcpCardOrStream
responses:
'200':
description: SSE stream (text/event-stream) or endpoint card (application/json)
content:
application/json:
schema:
type: object
example:
ok: true
service: bridge-watch MCP
serverInfo:
name: bridge-watch
version: 0.3.1
tools:
- name: get_label
credits: 1
usdc: '0.01'
- name: explain_transaction
credits: 2
usdc: '0.02'
- name: detect_cluster
credits: 5
usdc: '0.05'
- name: query_alerts
credits: 1
usdc: '0.01'
- name: alert_stats
credits: 1
usdc: '0.01'
- name: track_cctp
credits: 3
usdc: '0.03'
- name: list_paid_endpoints
credits: 1
usdc: '0.01'
freeTier:
enabled: true
tools:
- get_label
- explain_transaction
- detect_cluster
- query_alerts
- alert_stats
- track_cctp
- list_paid_endpoints
perIp: 7
dailyCap: 500
perTool: 1
payment:
protocol: x402 v2 (v1 X-PAYMENT compatible)
network: base
payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
asset: USDC
creditPerUsdc: 100
/.well-known/mcp.json:
get:
tags:
- MCP
summary: 'MCP client descriptor (auto-discovery: agents look here for /mcp)'
description: Static descriptor advertising the MCP endpoint so that agent tooling without a wallet can discover and connect to https://agentsapi.top/mcp automatically. Same-source with GET /mcp and MCP initialize.
operationId: wellKnownMcpJson
responses:
'200':
description: MCP descriptor
content:
application/json:
schema:
type: object
example:
mcpServers:
bridge-watch:
type: http
url: https://agentsapi.top/mcp
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key or funded payment address
x-mcp:
endpoint: https://agentsapi.top/mcp
transport: streamable-http
registry: top.agentsapi/bridge-watch
serverInfo:
name: bridge-watch
version: 0.3.1
protocolVersion: '2025-06-18'
freeTier:
enabled: true
tools:
- get_label
- explain_transaction
- detect_cluster
- query_alerts
- alert_stats
- track_cctp
- list_paid_endpoints
perIp: 7
dailyCap: 500
perTool: 1
tools:
- name: get_label
credits: 1
usdc: '0.01'
description: Look up the identity label of an EVM address (Base, open eth-labels dataset; mostly category tags rather than named entities). Returns which entity the address belongs to; unlabelled addresses return null. Call with no arguments for a free demo result.
readOnly: true
- name: explain_transaction
credits: 2
usdc: '0.02'
description: 'Explain what a transaction did: status, sender/receiver (with identity labels), transfer details, and whether it looks like a cross-chain bridge operation.'
readOnly: true
- name: detect_cluster
credits: 5
usdc: '0.05'
description: Detect the set of addresses funded by a single funder (shared funding-source cluster). Useful for sybil / entity detection.
readOnly: true
- name: query_alerts
credits: 1
usdc: '0.01'
description: Query historical alert records; filterable by address, rule kind, severity, and time range.
readOnly: true
- name: alert_stats
credits: 1
usdc: '0.01'
description: 'Alert statistics overview: totals, breakdown by kind / severity / address, and the latest alert time.'
readOnly: true
- name: track_cctp
credits: 3
usdc: '0.03'
description: 'CCTP cross-chain transfer tracking: given a source-chain tx hash, find which transfer it belongs to, how much moved, the destination chain, and whether it arrived. Supports Base → Ethereum and other CCTP chains.'
readOnly: true
- name: list_paid_endpoints
credits: 1
usdc: '0.01'
description: List every paid HTTP endpoint of this service with its live per-call price in USDC on Base. Takes no arguments. Call this first to discover what you can buy and what it costs.
readOnly: true
payment:
protocol: x402 v2 (v1 X-PAYMENT compatible)
network: base
payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
asset: USDC
creditPerUsdc: 100
howToCall:
- 'POST https://agentsapi.top/mcp with Content-Type: application/json and Accept: application/json, text/event-stream'
- 'Body is JSON-RPC 2.0: initialize (free) → tools/list (free) → tools/call (paid)'
- A paid tool/call returns a PaymentRequired object inside the JSON-RPC result; the /mcp protocol plane itself never returns HTTP 402
- 'Pay USDC on Base to payTo, then retry tools/call with the payer address as Authorization: Bearer <address> (or x402 payment-signature header)'
- 'Anonymous free tier: 7 tool calls per IP per day, 1 per tool across all 7 tools (get_label, explain_transaction, detect_cluster, query_alerts, alert_stats, track_cctp, list_paid_endpoints; no wallet, no signup)'
machineReadable:
mcpDescriptor: https://agentsapi.top/.well-known/mcp.json
serverCard: https://agentsapi.top/.well-known/mcp/server-card.json
x402Manifest: https://agentsapi.top/.well-known/x402
skill: https://agentsapi.top/skill.md
llmsTxt: https://agentsapi.top/llms.txt