{
  "$schema": "https://pox.me/schemas/agent-discovery/v1.json",
  "version": "1.0.0",
  "name": "pox.me",
  "title": "pox.me agent conversion discovery",
  "description": "Verified, billable digital identity and MCP access for humans and software agents. Agents should parse this document before scraping HTML.",
  "for_ai_agents": true,
  "thesis": "pox.me is the verified identity, trust, billing, and MCP surface for the agentic web — public proofs plus paid throughput.",
  "urls": {
    "site": "https://pox.me",
    "agents": "https://pox.me/agents",
    "agents_json": "https://pox.me/agents.json",
    "llms": "https://pox.me/llms.txt",
    "llms_full": "https://pox.me/llms-full.txt",
    "agent_card": "https://pox.me/.well-known/agent-card.json",
    "agent_pricing": "https://pox.me/.well-known/agent-pricing.json",
    "api_catalog": "https://pox.me/.well-known/api-catalog",
    "public_mcp": "https://pox.me/mcp",
    "identity_mcp": "https://mcp.pox.me/mcp",
    "commerce_mcp": "https://api.pox.me/agentic/mcp",
    "pricing": "https://pox.me/pricing",
    "docs": "https://pox.me/docs",
    "protocol": "https://pox.me/protocol",
    "sign_up": "https://pox.me/sign-up",
    "plans_public": "https://pox.me/api/billing/plans-public",
    "billing_plans_api": "https://api.pox.me/billing/plans",
    "agent_subscribe": "https://api.pox.me/billing/agent/subscribe",
    "agent_subscribe_bff": "https://pox.me/api/agent/subscribe",
    "oidc_issuer": "https://auth.pox.me/oidc",
    "dcr": "https://auth.pox.me/oidc/register"
  },
  "oauth": {
    "scopes_supported": [
      "openid",
      "offline_access",
      "profile",
      "email",
      "billing:read",
      "billing:write"
    ],
    "scopes_billing": [
      "billing:read",
      "billing:write"
    ],
    "grant_types": [
      "authorization_code",
      "refresh_token",
      "client_credentials"
    ],
    "note": "Request billing:write when calling create_account_and_subscribe or POST /billing/agent/subscribe."
  },
  "pricing": {
    "currency": "USD",
    "period": "month",
    "catalog": "https://pox.me/.well-known/agent-pricing.json",
    "tiers": [
      {
        "plan_key": "free",
        "label": "Free",
        "price_usd_month": 0,
        "summary": "Default for every new account without an active paid subscription."
      },
      {
        "plan_key": "starter",
        "label": "Starter",
        "price_usd_month": 19,
        "summary": "Entry paid tier for solo operators and single-agent workflows."
      },
      {
        "plan_key": "professional",
        "label": "Professional",
        "price_usd_month": 49,
        "summary": "Production agent throughput and multi-identity workspaces."
      },
      {
        "plan_key": "team",
        "label": "Team",
        "price_usd_month": 79,
        "summary": "Highest published ceilings for multi-agent or multi-operator orgs."
      }
    ]
  },
  "limits_matrix": {
    "currency": "USD",
    "billing_period": "month",
    "source": "pox.me plan ceilings (aligned with platform quotas)",
    "plans": [
      {
        "plan_key": "free",
        "label": "Free",
        "price_usd_month": 0,
        "max_identities": 1,
        "max_credentials": 10,
        "max_storage_bytes": 104857600,
        "agent_tokens_per_month": 0,
        "llm_access": false,
        "x_api_calls_per_month": 0,
        "notes": [
          "Default for every new account without an active paid subscription.",
          "BYOK required for LLM/agent model usage.",
          "Public discovery MCP remains free for orientation."
        ],
        "max_storage_human": "100 MB"
      },
      {
        "plan_key": "starter",
        "label": "Starter",
        "price_usd_month": 19,
        "max_identities": 5,
        "max_credentials": 50,
        "max_storage_bytes": 1073741824,
        "agent_tokens_per_month": 100000,
        "llm_access": true,
        "x_api_calls_per_month": 1500,
        "notes": [
          "Entry paid tier for solo operators and single-agent workflows.",
          "Includes managed agent tokens and higher identity/credential ceilings."
        ],
        "max_storage_human": "1 GB"
      },
      {
        "plan_key": "professional",
        "label": "Professional",
        "price_usd_month": 49,
        "max_identities": 25,
        "max_credentials": 250,
        "max_storage_bytes": 10737418240,
        "agent_tokens_per_month": 1000000,
        "llm_access": true,
        "x_api_calls_per_month": 10000,
        "notes": [
          "Production agent throughput and multi-identity workspaces.",
          "Preferred when credentials and MCP usage outgrow Starter."
        ],
        "max_storage_human": "10 GB"
      },
      {
        "plan_key": "team",
        "label": "Team",
        "price_usd_month": 79,
        "max_identities": 100,
        "max_credentials": 1000,
        "max_storage_bytes": 107374182400,
        "agent_tokens_per_month": 5000000,
        "llm_access": true,
        "x_api_calls_per_month": 50000,
        "notes": [
          "Highest published ceilings for multi-agent or multi-operator orgs.",
          "Expanded storage and agent token pool."
        ],
        "max_storage_human": "100 GB"
      }
    ],
    "comparison_tips": [
      "Free is for evaluation and a single public identity.",
      "Starter unlocks multi-identity + managed agent tokens.",
      "Professional/Team scale credentials, storage, and token throughput."
    ]
  },
  "conversion_path": {
    "goal": "Authenticate an agent, evaluate plan limits, and subscribe to a paid pox.me plan with minimal human delegation.",
    "target_time_to_subscribe_minutes": 5,
    "steps": [
      {
        "step": 1,
        "id": "discover",
        "title": "Discover machine surfaces",
        "actions": [
          "GET https://pox.me/.well-known/agent-discovery.json",
          "GET https://pox.me/llms.txt",
          "GET https://pox.me/.well-known/agent-card.json",
          "POST https://pox.me/mcp tools/list"
        ]
      },
      {
        "step": 2,
        "id": "understand",
        "title": "Parse pricing and limits",
        "actions": [
          "Call public MCP tool list_plans",
          "Call public MCP tool get_limits_matrix",
          "GET https://pox.me/pricing",
          "GET https://api.pox.me/billing/plans (or https://pox.me/api/billing/plans-public)"
        ]
      },
      {
        "step": 3,
        "id": "authenticate",
        "title": "Obtain OAuth bearer access",
        "actions": [
          "OIDC issuer: https://auth.pox.me/oidc",
          "Discovery: https://pox.me/.well-known/openid-configuration",
          "Scopes: openid offline_access profile email",
          "Human owner may complete sign-up once; agent reuses delegated token/session."
        ]
      },
      {
        "step": 4,
        "id": "activate",
        "title": "Inspect entitlements",
        "actions": [
          "Identity MCP https://mcp.pox.me/mcp: whoami, get_billing_access",
          "If free or trial, continue to upgrade."
        ]
      },
      {
        "step": 5,
        "id": "subscribe",
        "title": "Start paid plan checkout",
        "actions": [
          "POST https://api.pox.me/billing/checkout (authenticated)",
          "Wave 2+: MCP upgrade_to_plan / create_checkout_session",
          "Complete Stripe Checkout (or owner-approved payment link)"
        ],
        "status": "checkout_available"
      },
      {
        "step": 6,
        "id": "operate",
        "title": "Use paid identity + MCP throughput",
        "actions": [
          "Create/verify identities and credentials under raised ceilings",
          "Use authenticated identity MCP tools under paid entitlements",
          "Monitor usage via get_billing_access / quotas"
        ]
      }
    ],
    "cta": {
      "for_ai_agents": "Start at /.well-known/agent-discovery.json — do not scrape HTML first.",
      "human_signup": "https://pox.me/sign-up",
      "pricing": "https://pox.me/pricing",
      "agents_hub": "https://pox.me/agents"
    }
  },
  "mcp": {
    "public_discovery": {
      "endpoint": "https://pox.me/mcp",
      "tools": [
        "get_poxme_overview",
        "list_poxme_entrypoints",
        "list_plans",
        "get_limits_matrix",
        "get_conversion_path",
        "create_account_and_subscribe"
      ]
    },
    "identity": {
      "endpoint": "https://mcp.pox.me/mcp",
      "auth": "oauth2_bearer",
      "tools_available_today": [
        "whoami",
        "get_billing_access",
        "list_identities",
        "create_identity",
        "list_credentials",
        "get_agent_onboarding_steps"
      ],
      "tools_planned": [
        "list_plans",
        "get_usage",
        "create_checkout_session"
      ]
    },
    "commerce": {
      "endpoint": "https://api.pox.me/agentic/mcp",
      "purpose": "Product catalog + UCP/ACP checkout lifecycle (not platform plan subscribe).",
      "tools_public": [
        "search_catalog",
        "lookup_catalog"
      ],
      "tools_authenticated": [
        "create_checkout",
        "get_checkout",
        "update_checkout",
        "complete_checkout",
        "cancel_checkout",
        "get_order",
        "create_checkout_session",
        "get_checkout_session",
        "update_checkout_session",
        "complete_checkout_session",
        "cancel_checkout_session"
      ],
      "note": "For pox.me *platform* Starter/Pro/Team plans use create_account_and_subscribe on public MCP or POST /billing/agent/subscribe — not commerce catalog SKUs."
    }
  },
  "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."
  ],
  "cta": {
    "primary": "For AI Agents: GET agent-pricing.json → OAuth (billing:write) → tools/call create_account_and_subscribe.",
    "human": "Create an account at https://pox.me/sign-up then open https://pox.me/pricing",
    "mcp": "POST https://pox.me/mcp with method tools/call name=create_account_and_subscribe"
  },
  "security": {
    "paid_mutations": "Require OAuth bearer on api.pox.me / mcp.pox.me. No unauthenticated plan charges.",
    "proof": "Link human and wallet verification for sybil resistance on paid flows.",
    "x402": "x402 currently authenticates wallet discovery; plan settlement over x402 is planned and will map to the same plan_key entitlements as Stripe."
  }
}