Agent readiness
How safely an autonomous agent can discover, authenticate (via x402), call, and recover from errors on this API — scored against the public agent-readiness dimension model (spec presence, auth clarity, idempotency, error semantics, and more).
Audience: Agent developers, marketplace integrators (Poncho, pay.sh, MPPscan), and procurement teams evaluating x402 APIs.
Not marketing fluff: Each signal is observable from public URLs — OpenAPI, well-known discovery, response headers, and live probes on conc-exe.xyz.
What Concierge exposes
| Signal | URL / header | Role |
|---|---|---|
| OpenAPI 3.1 | GET /openapi.json | Canonical contract — info.x-guidance, x-payment-info, components.securitySchemes, examples on every operation |
| RFC 9727 catalog | GET /.well-known/api-catalog | Linkset index — OpenAPI, MCP, x402, agent card, AsyncAPI stub |
| x402 fan-out | GET /.well-known/x402 | Paid route list + ownership proofs for x402scan / Bazaar |
| Agent card | GET /.well-known/agent-card.json | HTTP A2A discovery; optional ERC-8004 mint on Base Identity Registry |
| MCP HTTP | GET /api/mcp | JSON-RPC tools/list · tools/call for intel routes |
| Verdict accuracy | GET /api/concierge-intel-accuracy | Free trust signal — 24h BTC alignment leaderboard · B2B case study |
| Official MCP Registry | xyz.conc-exe/concierge-intel | Published v1.1.0 — integration guide · Agent SDK |
| AsyncAPI stub | GET /asyncapi.json | Event contract placeholder (HTTP-only today; webhooks reserved) |
| LLM index | GET /llms.txt | Human + agent doc map |
| Rate-limit policy | X-RateLimit-Limit, RateLimit-Limit | 120 req/min soft limit on /api/* — documented in OpenAPI 429 responses |
| Idempotency | Idempotency-Key header | Optional on POST; reuse PAYMENT-SIGNATURE after settlement to avoid double-pay |
| Agent attribution | X-Agent-Id: agt_… | Registered agent identity — see Agent Identity |
| Consent | GET /robots.txt | Content-signal: search=yes, ai-input=yes, ai-train=no |
Twelve audit dimensions
Live audit via public probes — see Verify below. Dimensions scored 0–3 (spec presence, auth clarity, idempotency, and more):
| Dimension | Concierge posture |
|---|---|
| Spec presence | OpenAPI 3.1 at predictable URL, static + live |
| Auth model clarity | x402Payment security scheme + x-payment-info per route |
| Idempotency | Idempotency-Key documented; payment signature dedup guidance in info.x-guidance |
| Error semantics | components.schemas.ApiError — stable code enum; 400/402/429/500 on all paid ops |
| Rate-limit headers | X-RateLimit-* on API responses; Retry-After on 429 in spec |
| Dry-run / simulate | GET intel probes → 402; POST /api/token-pay-preview; playground |
| OpenAPI examples | operationId, request + response examples on every operation |
| MCP server | First-party HTTP MCP at /api/mcp |
| AsyncAPI / events | Stub at /asyncapi.json (no live webhooks yet) |
| RFC 9727 api-catalog | /.well-known/api-catalog linkset+json |
| Consent signals | Content-signal in robots.txt |
| Web Bot Auth | Signature-Agent header → agent identity docs |
| Trust / accuracy | GET /api/concierge-intel-accuracy in OpenAPI + agent card trust block |
Verify (integrators & CI)
# Live production probes (no API keys)
curl -s https://conc-exe.xyz/.well-known/api-catalog | jq '.linkset | length'
curl -s https://conc-exe.xyz/api/concierge-intel-accuracy | jq '.evaluated'
curl -s https://conc-exe.xyz/.well-known/agent-card.json | jq '.trust'
curl -sI https://conc-exe.xyz/api/concierge-intel-tvl -X POST | grep -i ratelimit
curl -s https://conc-exe.xyz/openapi.json | jq '.paths["/api/concierge-intel-accuracy"]'Use the Discover UI for a live dashboard of x402, MCP, accuracy, and OpenAPI probes.
Distribution
Metadata ships from conc-exe.xyz — registries and catalogs link here, not to source repositories.
| Channel | Status | Public URL |
|---|---|---|
| MCP Registry | Published | xyz.conc-exe/concierge-intel v1.1.0 · guide · SDK |
| x402scan | Verified | 38 paid + 2 public operations |
| MPPscan | Verified | Concierge Agent API profile |
| x402 List | Pending review | Submission fce940e8-f4db-4ba8-bef4-69081b3b8ef0 · four endpoint probes passed |
| CDP Bazaar / Agentic.Market | Activation pending | Bazaar metadata is live; requires one successful CDP-facilitated settlement before indexing |
thebuyside pay.discover | Pending merge | PR #2 · six verified intel routes |
| pay.sh catalog | Pending merge | PR #119 · expected FQN conc-exe/concierge-agent |
| Agent Skill (SKILL.md) | Published | /skills/concierge-intel/SKILL.md |
| B2B case study | Published | Procurement checklist + accuracy methodology |
Related pages
API Overview
Base URL, discovery table, CORS
For Builders
Integration paths — OpenAPI, AgentCash, pay.sh
B2B Case Study
Procurement checklist, desk workflow, accuracy trust
Discover UI
Live x402 fan-out, MCP, agent card probes
MCP Registry
Official listing — streamable HTTP at /api/mcp
Agent Card
A2A registry and agt_ identities
Concierge · Executive Lounge