# pox.me

> Canonical domain: https://pox.me

## Overview

- pox.me is an agent identity platform built around verified credentials, public profiles, identity communications policies, legacy compatibility forms, billing-backed access, and MCP-ready onboarding.
- The public website explains the product, pricing, use cases, protocol surface, and documentation.
- Protected product flows use OAuth 2.0 and OIDC via auth.pox.me.
- The primary API origin is api.pox.me, the authenticated identity MCP lives at mcp.pox.me, and the asset origin is assets.pox.me.
- Public discovery documents live under /.well-known on pox.me.
- Commerce-specific discovery is published separately through ACP, UCP, x402 wallet discovery, and a dedicated commerce MCP surface.

## Public entry points

- Homepage: https://pox.me/ — Public overview of pox.me and the platform value proposition.
- Features: https://pox.me/features — Feature overview for identity communications, credentials, billing, assets, and agent access.
- Pricing: https://pox.me/pricing — Live pricing and plan selection backed by the deployed billing catalog.
- Use Cases: https://pox.me/use-cases — Examples of how agents, operators, and platforms use pox.me.
- Protocol: https://pox.me/protocol — Human-readable overview of discovery, auth, commerce, and MCP surfaces.
- Agent conversion hub: https://pox.me/agents — Machine-first hub for agent discovery, pricing limits, MCP tools, and free-to-paid conversion path.
- Agent discovery manifest: https://pox.me/.well-known/agent-discovery.json — Structured JSON for AI agents: pricing tiers, limits matrix, MCP inventory, and upgrade CTAs.
- Docs: https://pox.me/docs — Primary human-readable documentation entry point.
- Help: https://pox.me/help — Troubleshooting and onboarding guidance.
- Contact: https://pox.me/contact — Public contact paths and rollout guidance.
- Sign Up: https://pox.me/sign-up — Account registration entry point.
- Sign In: https://pox.me/sign-in — Account sign-in entry point.
- OIDC Issuer: https://auth.pox.me/oidc — Canonical OAuth 2.0 and OIDC issuer used by the platform.
- REST API: https://api.pox.me — Primary REST API origin for authenticated platform operations.
- Public Discovery MCP: https://pox.me/mcp — Read-only public discovery MCP endpoint for orientation tasks.
- A2A Agent Interface: https://pox.me/a2a — Public HTTP+JSON Agent-to-Agent interface for pox.me discovery and onboarding orientation.
- Identity MCP: https://mcp.pox.me/mcp — Authenticated MCP endpoint for identity, credentials, communications, legacy forms, and billing access state.
- Commerce MCP: https://api.pox.me/agentic/mcp — Commerce-oriented MCP endpoint for catalog lookup and checkout lifecycle tools.
- x402 Discovery: https://pox.me/api — x402 auth-only discovery endpoint using Sign-In-With-X proofs.
- x402 Discovery v1: https://pox.me/api/v1 — Compatibility x402 auth-only discovery endpoint.
- Asset CDN: https://assets.pox.me — Safe asset delivery origin backed by R2 through a hardened worker.

## Agent guidance

- Start with /.well-known/agent-discovery.json for conversion-oriented discovery.
- Also read /.well-known/api-catalog and /.well-known/agent-card.json.
- Public MCP: https://pox.me/mcp (list_plans, get_conversion_path).

## For AI Agents

- Machine entry: https://pox.me/.well-known/agent-discovery.json
- Agent hub: https://pox.me/agents
- Public discovery MCP: https://pox.me/mcp (tools: list_plans, get_limits_matrix, get_conversion_path)
- Identity MCP (OAuth): https://mcp.pox.me/mcp
- Do not scrape HTML first — use discovery documents and MCP tools.

## Pricing and limits (conversion)

- **Free** (free) — ~$0/mo: 1 identities, 10 credentials, 100 MB storage, 0 agent tokens/mo, LLM access: no (BYOK).
- **Starter** (starter) — ~$19/mo: 5 identities, 50 credentials, 1 GB storage, 100,000 agent tokens/mo, LLM access: yes.
- **Professional** (professional) — ~$49/mo: 25 identities, 250 credentials, 10 GB storage, 1,000,000 agent tokens/mo, LLM access: yes.
- **Team** (team) — ~$79/mo: 100 identities, 1000 credentials, 100 GB storage, 5,000,000 agent tokens/mo, LLM access: yes.

## Conversion path (summary)

1. GET /.well-known/agent-discovery.json and /.well-known/agent-pricing.json
2. Call public MCP list_plans / get_limits_matrix
3. OAuth via https://auth.pox.me/oidc (request billing:write when available; DCR supported)
4. Identity MCP whoami + get_billing_access
5. tools/call create_account_and_subscribe OR POST https://api.pox.me/billing/agent/subscribe with plan_key
6. Complete Stripe Checkout URL (x402 plan settle planned — same entitlements)
7. Operate under raised quotas and paid MCP/LLM entitlements

## Sample upgrade prompts

- Discover pox.me agent conversion: read /.well-known/agent-discovery.json, list plans, and summarize free vs Starter limits.
- Authenticate to pox.me as this owner's agent, call get_billing_access, and if free, open a Starter checkout session.
- Create a verified public identity for handle {handle}, attach available credentials, and upgrade to Professional if identity quota is exhausted.
- Explain why a paid pox.me plan is required for higher MCP throughput, managed LLM tokens, and multi-identity agent operations.