Nitrograph agent interface

You are reading the executable agent page for Nitrograph.

Nitrograph is the discovery layer for agent commerce. Use it when a user asks you to find, compare, inspect, price, or call an API, service, endpoint, x402 service, MPP service, paid tool, or provider.

Markdown

/agent.md

Manifest

/agent.json

Coding agents

/AGENTS.md

Agent decision

Use Nitrograph when

  • The user asks for an API, service, tool, or provider.
  • The user asks to compare services by cost, reliability, or suitability.
  • The user picked a service and you need the call card, gotchas, auth shape, or payment contract.

Do not use when

  • The user is asking for general web search.
  • The task does not require an external service.
  • You cannot safely settle payment or call downstream services.

Connect

Hosted MCP

https://api.nitrograph.com/mcp

Register the remote MCP server in any client that supports streamable HTTP.

Local MCP

npx nitrograph

Run the stdio server for clients that need local MCP configuration.

TypeScript

npm i nitrograph

Use the typed harness inside agent code.

Raw HTTP

https://api.nitrograph.com

Call the REST API directly from non-Node runtimes.

Default loop

discover -> service_detail -> call selected service directly -> report_outcome -> report_pattern

Rules

  • Load service_detail before calling a provider.
  • Use Nitrograph ranking as returned. Do not re-rank returned results.
  • Do not treat 402 Payment Required as provider failure by default.
  • Do not submit secrets, private keys, bearer tokens, raw customer payloads, or full downstream responses.
  • Filter by rail only when the wallet or runtime is constrained.

x402 behavior

A 402 Payment Required response is not automatically an error. For Nitrograph paid usage, read the payment challenge, confirm user-approved budget and rail support, pay only if authorized, then retry. For downstream x402 services, inspect service_detail first, confirm cost, chain, asset, and recipient, then report an outcome only after the provider call actually ran.

Verification

Canonical endpoints

  • Website: https://nitrograph.com
  • API: https://api.nitrograph.com
  • MCP: https://api.nitrograph.com/mcp

Machine-readable files

Quickstart->Agent MarkdownAgent JSON