Polar

{
  "service_type": "platform",
  "base_url": "https://polar.sh",
  "auth_method": "api_key",
  "auth_config": {
    "type": "bearer_token",
    "header": "Authorization",
    "format": "Bearer {token}",
    "notes": "Polar uses organization access tokens (OATs) for API authentication. Tokens are created in the Polar dashboard under Settings > API. Both production and sandbox environments are supported with separate tokens."
  },
  "endpoints": [
    {
      "name": "API Reference",
      "url": "https://polar.sh/docs/api-reference",
      "description": "Full REST API documentation for products, customers, subscriptions, orders, checkouts, benefits, meters, events, and more."
    },
    {
      "name": "Products",
      "url": "https://polar.sh/docs/api-reference/products",
      "description": "Create, list, update, and archive products."
    },
    {
      "name": "Checkouts",
      "url": "https://polar.sh/docs/api-reference/checkouts",
      "description": "Create checkout sessions programmatically for custom pricing and flows."
    },
    {
      "name": "Subscriptions",
      "url": "https://polar.sh/docs/api-reference/subscriptions",
      "description": "Manage recurring subscriptions, trials, proration, and plan changes."
    },
    {
      "name": "Orders",
      "url": "https://polar.sh/docs/api-reference/orders",
      "description": "Retrieve and manage paid transactions, refunds, and invoices."
    },
    {
      "name": "Customers",
      "url": "https://polar.sh/docs/api-reference/customers",
      "description": "Customer management including state, portal access, and external IDs."
    },
    {
      "name": "Benefits",
      "url": "https://polar.sh/docs/api-reference/benefits",
      "description": "Manage automated benefits such as Discord roles, GitHub access, license keys, file downloads, and feature flags."
    },
    {
      "name": "Events / Usage",
      "url": "https://polar.sh/docs/api-reference/events",
      "description": "Ingest usage-based billing events and query meters."
    },
    {
      "name": "Meters",
      "url": "https://polar.sh/docs/api-reference/meters",
      "description": "Create and manage meters for usage-based billing aggregation."
    },
    {
      "name": "Webhooks",
      "url": "https://polar.sh/docs/integrate/webhooks",
      "description": "Configurable webhook endpoints for order, subscription, refund, and checkout events."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "model": "Merchant of Record (MoR) with transactional fees",
      "notes": "Polar charges a percentage fee per transaction plus payment processing fees. As a Merchant of Record, Polar handles global sales tax, VAT, and compliance. Exact fee structure varies; no monthly subscription required to start. Pricing is usage-based on transaction volume."
    }
  },
  "rate_limits": {
    "notes": "Polar documents API rate limits in their API reference. Default limits apply per organization token; sandbox and production environments may have separate limits. Specific numeric limits not provided in the input. Consult https://polar.sh/docs/api-reference for current limits."
  },
  "capabilities": [
    "Payments & billing infrastructure (Merchant of Record)",
    "One-time digital product sales",
    "Recurring subscriptions with trials, proration, and dunning",
    "Usage-based billing with event ingestion (LLM, S3, streams, delta-time strategies)",
    "Cost insights with cost events and traces",
    "Seat-based pricing with assignable seats and tiered pricing",
    "Unit-based pricing with tiered rates",
    "Checkout links, embedded checkout, embedded payment methods",
    "Checkout localization and tax-inclusive pricing",
    "Discounts and coupons",
    "Custom fields on checkout",
    "Automated benefits: Discord roles, GitHub repo access, license keys, file downloads, feature flags, Slack Connect channels, credits, custom benefits",
    "Customer portal (self-service subscription management)",
    "Customer state API for tight app integration",
    "Team management with roles and SSO",
    "Payouts via Stripe Connect Express",
    "Analytics dashboard and metrics",
    "Refunds (full and partial) and failed payment recovery",
    "Webhooks and Polar CLI for local webhook development",
    "Official TypeScript and Python SDKs",
    "Model Context Protocol (MCP) server for AI agent integration",
    "Zapier, Framer, Raycast, Fernand, ParityDeals, and Affonso integrations",
    "Sandbox environment for testing",
    "Stripe migration tooling",
    "Open Source codebase"
  ],
  "raw_analysis": "Polar (polar.sh) is a payments and billing platform positioning itself as an 'Open Source & Global Merchant of Record' that lets developers turn software into a business with '6 lines of code.' It is explicitly developer-focused and serves indie developers, small SaaS teams, and startups selling digital products, subscriptions, and usage-based services.\n\nService 

3/3 tests passed

{
  "overall": 84,
  "dimensions": {
    "token_efficiency": 9.0,
    "first_try_success": 8.0,
    "response_parseability": 9.0,
    "error_clarity": 8.5,
    "doc_quality": 9.0,
    "auth_simplicity": 8.0,
    "latency": 9.5,
    "consistency": 8.5
  },
  "pricing_normalized": {
    "model": "pay-per-transaction",
    "fixed_monthly": 0,
    "platform_fee": "percentage of transactions (varies)",
    "notes": "No subscription required. Merchant of Record handles global tax/VAT compliance. Free to start; costs scale with transaction volume."
  },
  "issues": [
    "Exact fee percentage is not clearly stated in the provided data — users must check pricing page separately",
    "No A2A agent identity/payment protocol mentioned for autonomous agent onboarding",
    "Freemium MoR model means real cost predictability is low for high-volume agents"
  ],
  "recommendations": [
    "Surface exact transaction fee tiers in machine-readable form (llms.txt already exists — extend it with a pricing.json) to improve agent token efficiency",
    "Consider publishing uptime/status API endpoint for consistency verification",
    "MCP server is a strong agent-native signal — highlight it prominently in llms.txt",
    "Add explicit auth flow documentation for headless/agent signup if applicable"
  ]
}