AgentGraph

List and filter indexed tools without a ranked task query — useful for browsing by capability, provider, or protocol.

Get the full public profile of a single owner-submitted agent by id, including its reported interaction summary.

Get the machine-readable invocation contract for an owner-submitted agent: whether it's directly callable, which protocol (MCP, A2A, HTTP_JSON), the endpoint, auth requirements, input/output schemas where declared, and pricing (result.pricing — { mode: "FREE" } or { mode: "FIXED", amount, amountAtomic, currency, paymentProtocol, network, platformFeeBps, paymentRecipient }). An Agent may expose more than one contract for different capabilities (e.g. one for image comparison, a separate one for free-text idea evaluation) — pass `capability` to get the one that actually serves it; without it, this returns the Agent's primary/default contract plus a `multipleContracts`/`invocationsUrl` pointer if there's more than one. Use get_agent_invocations to list every contract at once. For a FIXED/X402 contract, use get_payment_requirement to obtain a standards-compliant x402 v2 payment requirement before invoking. Owner-submitted and unverified unless verificationStatus says otherwise — AgentGraph does not call this endpoint itself; the caller invokes the provider directly and reports the outcome via the interactions API.

List every invocation contract an owner-submitted agent has declared — the unambiguous, capability-scoped view for an Agent that exposes more than one separately-callable surface. Each entry lists exactly which capabilities it serves. AgentGraph does not call any of these itself.

Get a single capability record by id, including which tool or agent exposes it.

V0.4 demand intelligence: deterministic aggregates over real search telemetry — top intent concepts, top matched capabilities (rank<=10), and how many recent searches had zero currently-callable Agent in their top 10. No LLM/clustering — every result reports its sample size and window. Mirrors GET /api/demand.

V0.4 opportunity feed: capabilities with real recent demand (>=minSampleSize top-10 matches) sorted by weakest current callable-Agent supply first. Every entry is a real, sample-sized aggregate — see excludedForSampleSize for how many low-sample capabilities were dropped rather than shown with a misleading count. Mirrors GET /api/opportunities.

V0.6 — for a FIXED/X402 invocation contract, returns a real, standards-compliant x402 v2 PaymentRequired object (x402Version, resource, accepts[]) built fresh from that contract's current price/network/recipient. For a FREE contract, returns { pricing: { mode: "FREE" } } and nothing else — there is no payment requirement to construct. AgentGraph is not the resource being paid for: `resource.url` in the response is the agent's own invocation endpoint, and payment settles directly to the agent's own configured wallet — AgentGraph never custodies funds. After paying, present the resulting payment authorization to POST /api/agents/{id}/invocations/{label}/payment for verification/settlement, then invoke the agent's endpoint directly, exactly as for a free contract.

Get the full public profile of a single indexed tool by id.

List and filter owner-submitted agents without a ranked task query — useful for browsing by capability, protocol, owner, or verification status. Use search_capabilities for a ranked task-driven search across both tools and agents.

Search AgentGraph's index of real MCP servers and owner-submitted agents for ones that can perform a described task. Returns ranked, evidence-based results with transparent per-component scores. Every result includes machine-readable pricing (result.invocation.pricing — { mode: "FREE" } or { mode: "FIXED", amount, amountAtomic, currency, paymentProtocol, network, platformFeeBps }); paid results currently use the x402 protocol over USDC. Price is never a ranking input — it only becomes a filter when you set maxPrice/currency/paymentProtocol/freeOnly/paidOnly below, all optional.