{
  "name": "Ysaere",
  "description": "Prepaid multi-agent intelligence over MCP. Async run → poll → provenance receipt (integrity, not verified fact). Five status tools are free; intelligence runs debit credits.",
  "url": "https://mcp.ysaere.com/mcp",
  "transport": "streamable-http",
  "version": "1.0",
  "authentication": {
    "schemes": ["bearer", "oauth2"],
    "bearer": {
      "header": "Authorization",
      "format": "Bearer <token>",
      "prefix": "ysa_prod_",
      "notes": "Authorization: Bearer is the ONLY accepted credential header on both MCP and REST /v1. An x-api-key header is not read. Sandbox keys use ysa_test_* (mock, no credits). Every request must carry the header, including requests on an established mcp-session-id."
    },
    "oauth2": {
      "notes": "OAuth 2.1 PKCE for host connectors. Protected-resource metadata at https://mcp.ysaere.com/.well-known/oauth-protected-resource (RFC 9728). Dynamic client registration (RFC 7591) is supported; static Client ID claude.ai is also accepted. Access tokens are ysa_oa_* and may rotate mid-session — the server re-binds on the same principal.",
      "protected_resource_metadata": "https://mcp.ysaere.com/.well-known/oauth-protected-resource"
    }
  },
  "signup": {
    "url": "https://app.ysaere.com/auth/register",
    "free_credits": 150,
    "notes": "150 free credits on email-verified signup — enough for one Company Intelligence (100) or one Angel Intelligence (50) run. No card required. There is no anonymous tool access: every tool call requires a credential."
  },
  "free_tools": [
    "estimate_credits",
    "check_balance",
    "check_report_status",
    "wait_for_report",
    "verify_provenance"
  ],
  "namespaces": ["intel", "status"],
  "docs": "https://ysaere.com/mcp/",
  "openapi": "https://api.ysaere.com/v1/openapi.json",
  "llms_txt": "https://ysaere.com/llms.txt",
  "builders": "https://ysaere.com/builders/",
  "terms": "https://app.ysaere.com/legal/api-terms",
  "topup_url": "https://app.ysaere.com/account/usage",
  "clients": {
    "typescript": "npm install @ysaere/sdk",
    "cli": "npm install -g @ysaere/cli",
    "python": "pip install ysaere"
  },
  "billing": {
    "model": "prepaid_credits",
    "credit_usd": 0.1,
    "mint": "stripe_checkout_only",
    "insufficient_credits": "HTTP 402 with flat required / balance / topup_url"
  },
  "provenance": {
    "integrity": true,
    "factual_truth": false,
    "verify": "https://app.ysaere.com/verify"
  }
}