# IntelClaw — Agent Integration Guide (llms-full.txt)

> Short index: https://intelclaw.org/llms.txt. Agent card: https://intelclaw.org/.well-known/agent.json.
> Listings shown: 0.
> Support: https://support.intelclaw.org

## Access

Paid resources live at GET /api/v1/resources/{slug}.

- A paid call without a key returns HTTP 401. A key whose account has no subscription to that listing returns HTTP 403.
- The 401 body is {error, hint, sample, discovery}, pointing to the free reads.
- Paid retry: send your IntelClaw API key as `Authorization: Bearer im_...`.
  Key policy: Any account can create a free API key. Samples and discovery need no key at all; paid data needs a subscription to that listing.
  Get a key: sign up at /sign-up, then POST /api/keys {name}. The key is shown once.
  Unlock paid data: subscribe at /checkout?listing={slug}.
- People and agents use the same key.
- 403 also covers a metered plan whose monthly cap is used up. 429: obey `Retry-After`.
  502: source temporarily unavailable (retry later). A 502 may include the sample,
  marked degraded; degraded responses are never counted as paid use.
- Rate limits: Without a key: 60 requests per minute. With a key: 120 requests per minute per listing. Metered plans include 10,000 calls a month; calls past the cap return HTTP 403. The Live Price Feed plan has no monthly cap.
- Each paid JSON response includes meta.bodySha256, the SHA-256 of the JSON body.
  When signing is enabled, meta.receiptPayload and meta.receiptSignature cover the slug,
  serve time, source and that hash, so you can audit what you received.
- Reviews: POST /api/reviews while signed in with an active subscription or a past paid
  call to that listing.

## MCP usage

MCP endpoint: https://intelclaw.org/api/mcp (JSON-RPC 2.0 over HTTP, stateless).
- initialize → capabilities (tools).
- tools/list → live MCP tools with input schemas
  (POST {jsonrpc:'2.0',id,method:'tools/list'}).
- tools/call {name, arguments} → same gate as REST: your IntelClaw API key (Bearer im_…)
  plus a subscription to the listing.
- Unpaid calls return ERR_PAYMENT_REQUIRED (-32001) with data.httpStatus 401 (no key)
  or 403 (no subscription for this listing).

## Sample flow

1. GET /api/v1/resources/{slug}?sample=1 — free sample payload (no key needed).
2. GET /api/v1/resources/{slug}?discovery=1 — machine metadata for the listing.
3. GET /api/v1/resources/{slug} — expect 401 until you send your IntelClaw API key.
4. Retry with `Authorization: Bearer im_...`. Expect 403 until your account subscribes.

## Per-listing entries

## Trust, reviews, and comparison
- How verification works: https://intelclaw.org/trust. Verified means the listing's origin passed a health check and a person approved the listing. Health checks run every 6 hours.
- Reviews JSON: https://intelclaw.org/api/reviews?slug={listingSlug} (GET lists reviews; POST while signed in with an active subscription or a past paid call to that listing creates one)
- Compare listings: https://intelclaw.org/compare?slugs={slug1,slug2,slug3}

## Billing and terms
- Billed monthly by Polar, our merchant of record. Cancel anytime from your dashboard. Refunds: see https://intelclaw.org/pricing.
- Terms: https://intelclaw.org/terms
- Privacy: https://intelclaw.org/privacy. Per-listing machine-readable terms ship in ?discovery=1.