Browse all documentation
Developers · 6 of 7

Public APIs and manifests

Machine-readable discovery, workflows, evidence, and aggregate usage.

betaserver 3.0 · 79 MCP tools · platform contract v1Verified 2026-07-29Owner: ENS.Tools Developer Platform

The public manifests make the platform discoverable without scraping the UI. HTTP APIs expose the evidence and coordination services behind agent health, routing, policies, commerce, and fleet control.

/.well-known/mcp.json — MCP server metadata, protocol, safety, categories, standards, and tool count.
/.well-known/agent-skills/index.json — documented workflow catalogue.
/.well-known/agent-capabilities.json — authentication and payment feature flags.
/.well-known/agent-card.json — public service card.
/llms.txt, /llms-full.txt, and /skill.md — short and long machine-use instructions.
/api/agents/stats — aggregate-only 30-day discovery, initialize, catalogue, call, success, reliability, and tool usage without arguments or caller identities.
Production contract

Before you run this workflow

Networks

  • Ethereum mainnet for onchain plans
  • HTTPS for MCP and public APIs

Prerequisites

  • JSON-RPC 2.0 client for MCP
  • Read the live platform contract and tool schemas at runtime

Wallet permissions

  • MCP never receives private keys
  • Prepared writes must be reviewed, signed, and broadcast by a separate wallet

Expected result

  • Structured JSON data or an unsigned plan with chain, target, calldata, value, and safety metadata

Errors and recovery

  • Call tools/list again after schema errors
  • Back off after rate limits
  • Simulate immediately before signing

Agent APIs

POST /api/agents/capabilities — check published endpoints
GET /api/agents/capabilities — read stored observation history
GET/POST /api/agents/monitoring — signed schedules, observations, incidents, and alerts
POST /api/agents/route — rank an intent with evidence
GET/POST /api/agents/policies — prepare, publish, inspect, verify, and revoke
GET/POST /api/agents/enforce — atomically authorize execution and inspect durable usage
GET/POST /api/agents/jobs — jobs, quotes, acceptance, Base/Ethereum USDC/WETH escrow preparation, funding plans, and evidence
POST /api/agents/fleet — composed inspection, selected unsigned updates, and evidence-gated rollouts
POST /api/v1/tools — API-key authenticated live and sandbox gateway with quota receipts
GET/POST /api/developers/account — wallet challenges, key lifecycle, account and usage
GET/POST /api/developers/billing — Base USDC readiness, permission registration, explicit first payment, refresh, failed-payment retry and revocation
GET /api/openapi.json — OpenAPI 3.1 generated from the live runtime catalogue

Runtime SDKs and instructions

/sdk/ens-agent-enforcer.mjs — zero-dependency JavaScript authorizer client and middleware
/sdk/ens-agent-enforcer.d.ts — TypeScript declarations
/.well-known/agent-skills/policy-enforcement.json — machine-readable fail-closed workflow

Other public APIs

Marketplace listings, listing detail, activity, statistics, and GET /api/marketplace/top-sales
GET /api/market/pulse — rolling registrar, marketplace, and collection snapshot
GET /api/portfolio/:identity — timestamped public Portfolio 2.0 snapshot and build state
Semantic domain search
ENS network analytics
Service health