---
title: "Public APIs and manifests"
description: "Machine-readable discovery, workflows, evidence, and aggregate usage."
canonical: "https://ens.tools/docs/public-apis"
section: "Developers"
stability: "beta"
version: "server 3.0 · 80 MCP tools · platform contract v1"
verifiedAt: "2026-07-29"
owner: "ENS.Tools Developer Platform"
---

# Public APIs and manifests

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

## Overview

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.

## What this covers

- /.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.

## 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

## Read capability flags

> The MCP baseline remains public. Wallet-owned API keys, quotas, and sandbox fixtures are active. Recurring official Base USDC is the sole platform-capacity purchase path and is fail-closed until providers.base.available=true; Stripe, direct transfers, native ETH, OAuth, ERC-8128, per-call x402, and MPP remain disabled. Agent-job escrow and ENS or marketplace costs are separate flows and never activate capacity.

## Related guides

- [MCP quickstart](https://ens.tools/docs/mcp-quickstart)
- [Complete MCP tool catalogue](https://ens.tools/docs/mcp-tools)
- [Marketplace integration](https://ens.tools/docs/marketplace-integration)