Premium · ProMCP tool: run_<agent>

Each agent does a whole job in one call and returns a verdict, a plain summary, a structured result, sourced reasons and a proof id. Inputs differ per agent; see Agents for each one.

Catalog with input schemas #

GET/v1/agents

Request

curl "https://coingraph.ai/api/v1/agents"

One agent's card #

GET/v1/agents/{id}

Parameters

idstring· pathrequired
e.g. trade-gatekeeper.

Request

curl "https://coingraph.ai/api/v1/agents/trade-gatekeeper"

Run an agent #

POST/v1/agents/{id}

Parameters

idstring· pathrequired
e.g. trade-gatekeeper.
bodyobject· bodyrequired
The agent's input; see its page.

Trade Gatekeeper: buy $5K of SOL

Request

curl -X POST "https://coingraph.ai/api/v1/agents/trade-gatekeeper" \
  -H "content-type: application/json" \
  -d '{"token":"solana","size_usd":5000,"side":"buy"}'

Response · real, captured 2026-10-06 23:24 UTC · long lists trimmed

{
  "object": "agent_run",
  "id": "run_2620bb88435002c82aed",
  "as_of": "2026-10-06T23:21:51.905Z",
  "data": {
    "run_id": "run_2620bb88435002c82aed",
    "agent": "trade-gatekeeper",
    "agent_version": "1.0.0",
    "as_of": "2026-10-06T23:21:51.905Z",
    "verdict": "ALLOW",
    "summary": "ALLOW: $5K buy of SOL fits current liquidity (under 0.01% impact via exchange order books).",
    "result": {
      "token": {
        "id": "solana",
        "symbol": "SOL"
      },
      "side": "buy",
      "size": {
        "requested_usd": 5000,
        "max_safe_usd": 5000
      },
      "impact": {
        "best_route": "exchange order books",
        "best_pct": 0,
        "routes": [
          {
            "route": "exchange order books",
            "impact": 0
          }
        ],
        "limit_pct": 1,
        "share_of_daily_volume_pct": 0
      },
      "check": {
        "verdict": "proceed",
        "confidence": 0.86,
        "dimensions": {
          "momentum": "ok",
          "liquidity": "ok",
          "leverage": "ok",
          "onchain": "ok",
          "supply": "ok",
          "context": "ok",
          "contract": "unassessed"
        },
        "evaluation_id": "eval_301dfef4e441c9d2fb81"
      },
      "policy": null,
      "latest_brief": null
    },
    "reasons": [
      {
        "text": "$5K buy: under 0.01% impact on the best route (exchange order books; limit 1%), check verdict proceed",
        "source": "coingraph:evaluate"
      }
    ],
    "warnings": [],
    "links": {
      "proof": "/api/v1/verify/eval_301dfef4e441c9d2fb81"
    },
    "disclaimer": "CoinGraph never trades, holds funds or gives financial advice. The caller decides.",
    "hash": "56e179df3b8f7f9d5ffeb8284e305c7f3d0294e9d33e6b3d5e18b2df05e4ea55",
    "verify_url": "https://coingraph.ai/api/v1/verify/run_2620bb88435002c82aed"
  },
  "sources": []
}

Response #

Inside data:

Field	Contents
`run_id, agent, verdict, summary`	The decision in one line.
`result`	The structured answer, different per agent.
`reasons[], warnings[]`	Why, each with its source.
`hash, verify_url`	The proof.

Pricing #

Listing is free. Runs are Premium (5 tADA) or Pro (10 tADA) via x402, depending on the agent. Without payment a paid call answers 402 with a PAYMENT-REQUIRED header; design partners send Authorization: Bearer cg_… instead. How payment works.

See every agent's inputs and real examples under Agents.