UPS

{
  "service_type": "platform",
  "base_url": "https://www.ups.com/upsdeveloperkit",
  "auth_method": "api_key",
  "auth_config": {
    "header": "accessKey",
    "api_key_required": true,
    "notes": "UPS requires an API key obtained from the UPS Developer Kit portal. Authentication is via API key in request headers, and often a username/password for specific services."
  },
  "endpoints": [
    "/api/rating",
    "/api/shipments",
    "/api/tracking",
    "/api/addressvalidation",
    "/api/oauth",
    "/api/oauth/token",
    "/api/oauth/authorize"
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Limited free access to certain APIs like Address Validation and Rating for testing (with volume limitations)",
      "paid_tier": "Custom pricing for commercial use, volume-based, requires contract for access to full Shipment, Tracking, and OAuth features"
    }
  },
  "rate_limits": {
    "notes": "Rate limits vary by API and plan. UPS provides quota and usage limits per user and per API, typically defined in the developer agreement. Testing keys have lower limits.",
    "typical_limits": "Not publicly published; enforced via API key usage monitoring"
  },
  "capabilities": [
    "Shipment creation and management",
    "Package tracking (using tracking numbers)",
    "Address validation and geocoding",
    "Rating and shipping rate quotes",
    "OAuth 2.0 authentication for secure integrations",
    "Webhooks for shipment status updates",
    "Label generation and printing",
    "Shipment pickup scheduling",
    "International shipping support and customs documentation",
    "Integration with UPS WorldShip and other enterprise tools"
  ],
  "raw_analysis": "UPS Developer Kit is a mature and comprehensive platform for logistics and shipping operations, targeting businesses of all sizes that need to integrate UPS shipping services into their applications. It provides a REST API (and SOAP for older integration) for core shipping functions like rating, shipment creation, tracking, and address validation. The platform is well-established with extensive documentation, SDKs in multiple languages, and a testing environment. Authentication typically requires an API key and also uses OAuth 2.0 for user authorization, which is becoming the standard for UPS APIs. The pricing model is freemium, with a free testing tier and paid commercial plans based on volume. Integrations include major e-commerce platforms (Shopify, Magento, etc.) and enterprise ERPs (SAP, Oracle), as well as direct API integration. Rate limits are not publicly disclosed and are enforced per account, requiring a contract for higher throughput. Overall, it is a reliable, enterprise-grade platform with a strong developer ecosystem, though its complexity may be overkill for small casual developers."
}

0/3 tests passed

```json
{
  "overall": 22,
  "dimensions": {
    "token_efficiency": 4.0,
    "first_try_success": 2.0,
    "response_parseability": 8.0,
    "error_clarity": 2.0,
    "doc_quality": 3.0,
    "auth_simplicity": 2.0,
    "latency": 1.0,
    "consistency": 0.0
  },
  "pricing_normalized": {
    "free_tier": "Limited free access to Address Validation and Rating APIs with volume caps",
    "paid_tier": "Custom volume-based contract required for Shipment, Tracking, and OAuth features"
  },
  "issues": [
    "Website unreachable — all 3 checks timed out at ~30 seconds with null status codes",
    "No llms.txt available for machine-readable documentation",
    "No robots.txt to guide crawlers",
    "OAuth 2.0 required for full features — creates onboarding friction for agents",
    "Core features (shipments, tracking) locked behind custom contracts — no self-serve signup",
    "No status page or uptime indicator visible in checks",
    "Pricing requires human negotiation — agents cannot independently provision access"
  ],
  "recommendations": [
    "Fix website availability — all endpoints returning 30s timeouts is critical",
    "Publish an llms.txt file with API schemas and quickstart guides",
    "Offer self-serve API keys for at least Rating and Address Validation APIs",
    "Add a public status page with uptime history",
    "Simplify auth with a magic-link flow or pre-approved test keys for agents",
    "Provide a clear 'Getting Started' doc that agents can ingest in under 1KB of tokens"
  ]
}
```