agentsapi-top MCP API

Model Context Protocol (JSON-RPC 2.0 over HTTP) endpoint — 7 paid tools with an anonymous free tier

Operations 3

POST /mcp MCP JSON-RPC 2.0 endpoint (7 tools, x402 metered) #
GET /mcp Open the MCP SSE stream, or fetch the machine-readable endpoint card #
GET /.well-known/mcp.json MCP client descriptor (auto-discovery: agents look here for /mcp) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/agentsapi-top:agentsapi-top-mcp-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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 Specification

agentsapi-top-mcp-api-openapi.yml Raw ↑
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