AgentWeb API Reference

AgentWeb exposes public discovery, readiness scanning, agent commerce setup, webhook, MCP, and verification surfaces for AI agents and agentic products.

Standard discovery URLs

• /openapi.json - OpenAPI 3.1 contract.
• /.well-known/openapi.json - well-known OpenAPI mirror.
• /.well-known/mcp/tools.json - public MCP tool manifest.
• /.well-known/mcp/apps.json - MCP Apps resources for setup, auth, payment authority, and verification.
• /.well-known/mcp/server-card.json - public MCP server card.
• /.well-known/agent-commerce.json - delegated payment and agent commerce metadata.
• /.well-known/payment-protocols.json - ACP, UCP, Stripe, OAuth, and payment protocol signals.

Runtime origins

• Public site: https://agentweb.us
• MCP runtime: https://mcp.agentweb.us/mcp
• MCP health: https://mcp.agentweb.us/health
• Live MCP tools: https://mcp.agentweb.us/.well-known/mcp/tools.json

Agent-callable entrypoints

• POST /api/readiness/scan audits whether a business is discoverable, understandable, integratable, and usable by agents.
• POST /api/billing/create-checkout-session creates a scoped Stripe Checkout handoff after payment authority exists.
• POST /api/billing/webhook receives Stripe-signed events and applies entitlements. External agents should not call it.
• POST https://mcp.agentweb.us/mcp accepts MCP Streamable HTTP requests.

Related docs

• API guide
• Webhook guide
• Agent commerce guide
• Agent auth and delegated access
• MCP Apps and tool definitions
• ACP and UCP commerce support
• AgentWeb developer resources for AI agent payment processing
• AI agent payment processing use case
• Agentic payment workflows use case