API Reference

REST API for querying llms.txt vendor data. Free tier requires no authentication.

OpenAPI 3.0 Spec/api/v1/openapi

Base URL

https://llms-txt-feed.vercel.app/api/v1

Authentication

Pass your API key as a Bearer token. Requests without a key receive free-tier access.

curl https://llms-txt-feed.vercel.app/api/v1/feed \
  -H "Authorization: Bearer ltf_YOUR_API_KEY"

Endpoints

GET/api/v1/feed

Main feed — vendor metadata, latest snapshots, and recent diffs.

Auth: Optional — unlocks diff content for starter/pro tiers

Query parameters

vendorstring— Filter by vendor slug

sinceISO 8601— Only snapshots after this date

GET/api/v1/vendors

List all active vendors with metadata.

Auth: None

GET/api/v1/content/:slug

Raw llms.txt content for a vendor (sandboxed, security-gated).

Auth: None

GET/api/v1/stats

Aggregate feed statistics.

Auth: None

GET/api/v1/pricing

Pricing tiers and limits.

Auth: None

Intelligence API

AI-generated change analysis for tracked vendors. Requires starter tier or above.

GET/api/v1/intelligence

Query intelligence reports — summaries of what changed, why it matters, and key quotes.

Auth: Required — starter tier minimum (403 for free)

Query parameters

vendorstring— Filter by vendor slug

sinceISO 8601— Only reports after this date

min_significance1-5— Minimum significance threshold (default: 1)

categorystring— Filter by category (e.g. documentation, api-update)

limitnumber— Max results, capped at 100 (default: 50)

Response fields

summary— Human-readable change description

significance— 1 (trivial) to 5 (breaking change)

categories— Array of change categories

sections_added— New sections detected

sections_removed— Sections that were removed

sections_modified— Sections with content changes

key_quotes— Notable quotes from the changed content

Tier limits

Starter: 90 days history. Pro: full history.

GET /api/v1/intelligence?vendor=anthropic&min_significance=3

{
  "_meta": {
    "service": "jadecli llms.txt intelligence",
    "tier": "starter",
    "count": 1,
    "filters": {
      "vendor": "anthropic",
      "since": null,
      "min_significance": 3,
      "category": null,
      "limit": 50,
      "history_days": 90
    }
  },
  "intelligence": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "vendor": {
        "name": "Anthropic",
        "slug": "anthropic",
        "domain": "platform.claude.com"
      },
      "summary": "Added new tool-use documentation section...",
      "significance": 4,
      "categories": ["documentation", "api-update"],
      "sections_added": ["Tool Use"],
      "sections_removed": [],
      "sections_modified": ["Getting Started"],
      "key_quotes": ["Tool use is now generally available..."],
      "byte_size_change_pct": 12.5,
      "analysis_mode": "full",
      "created_at": "2026-02-28T06:00:00.000Z"
    }
  ]
}

Webhooks API

GET/api/v1/webhooks

List all active webhooks for the authenticated API key.

Auth: Required — pro tier (403 for starter/free)

POST/api/v1/webhooks

Auth: Required — pro tier (403 for starter/free)

Request body (JSON)

urlstring— HTTPS endpoint to receive webhook payloads

eventsstring[]— Event types to subscribe to

Available events

intelligence.high_significance— Fired when a vendor change is scored with high significance

DELETE/api/v1/webhooks

Deactivate a webhook by ID.

Auth: Required — pro tier (403 for starter/free)

Query parameters

idstring— Webhook ID to deactivate

Webhook signature verification

Payloads are signed with HMAC-SHA256 using your webhook secret. Verify the signature from the X-LTF-Signature header before processing events.

GET /api/v1/webhooks

{
  "_meta": { "count": 1, "tier": "pro" },
  "webhooks": [
    {
      "id": "wh_abc123",
      "url": "https://example.com/webhook",
      "events": ["intelligence.high_significance"],
      "active": true,
      "created_at": "2026-02-28T06:00:00.000Z",
      "updated_at": "2026-02-28T06:00:00.000Z"
    }
  ]
}

POST /api/v1/webhooks — signing secret is only returned at creation time

{
  "webhook": {
    "id": "wh_abc123",
    "url": "https://example.com/webhook",
    "events": ["intelligence.high_significance"],
    "active": true,
    "created_at": "2026-02-28T06:00:00.000Z"
  },
  "secret": "whsec_...base64url..."
}

MCP Server v2

Streamable HTTP transport for remote MCP clients. Compatible with any MCP-capable agent or IDE.

POST/api/mcp/v2

Send a JSON-RPC request to the MCP server.

Auth: Optional — determines tier for rate limiting

GET/api/mcp/v2

Open a server-sent events (SSE) stream for receiving server notifications.

Auth: Optional — determines tier for rate limiting

DELETE/api/mcp/v2

Terminate the MCP session.

Auth: Optional — determines tier for rate limiting

Available tools

list_vendorsget_vendor_contentsearch_vendorsget_feedget_statsget_pricingget_diff_summaryget_guide

Same tool set as the v1 SSE transport. Uses the Streamable HTTP protocol from @modelcontextprotocol/sdk for broader client compatibility.

Client configuration

{
  "mcpServers": {
    "llms-txt-feed": {
      "type": "streamable-http",
      "url": "https://llms-txt-feed.vercel.app/api/mcp/v2",
      "headers": {
        "Authorization": "Bearer ltf_YOUR_API_KEY"
      }
    }
  }
}

Quick Start Examples

Copy-paste curl commands to start querying the API immediately.

Get the feed (no auth needed)

Returns vendor metadata, latest snapshots, and recent diffs.

Request

curl https://llms-txt-feed.vercel.app/api/v1/feed

Response

{
  "_meta": {
    "service": "jadecli llms.txt feed",
    "version": "0.2.0",
    "vendor_count": 5,
    "tier": "free"
  },
  "feed": [
    {
      "vendor": { "name": "Anthropic", "slug": "anthropic", "domain": "platform.claude.com", "category": "ai-platform" },
      "latest": { "content_hash": "a1b2c3...", "byte_size": 1024, "fetched_at": "2026-02-28T06:00:00.000Z" },
      "recent_change": null
    }
  ]
}

Search vendors

Full-text search across vendor names with optional category filter.

Request

curl "https://llms-txt-feed.vercel.app/api/v1/vendors/search?q=ai&category=ai-platform"

Response

{
  "_meta": { "count": 1, "query": "ai", "category": "ai-platform" },
  "vendors": [
    { "name": "Anthropic", "slug": "anthropic", "domain": "platform.claude.com", "category": "ai-platform" }
  ]
}

Get vendor details

Metadata and latest snapshot for a single vendor by slug.

Request

curl https://llms-txt-feed.vercel.app/api/v1/vendors/stripe

Response

{
  "vendor": {
    "name": "Stripe",
    "slug": "stripe",
    "domain": "docs.stripe.com",
    "category": "payments",
    "llms_txt_url": "https://docs.stripe.com/llms.txt"
  },
  "latest_snapshot": {
    "content_hash": "d4e5f6...",
    "byte_size": 2048,
    "line_count": 85,
    "link_count": 32,
    "fetched_at": "2026-02-28T06:00:00.000Z"
  }
}

Authenticated request (intelligence)

AI-generated change analysis. Requires starter tier or above.

Request

curl -H "Authorization: Bearer ltf_your_key" \
  https://llms-txt-feed.vercel.app/api/v1/intelligence

Response

{
  "_meta": { "tier": "starter", "count": 1 },
  "intelligence": [
    {
      "vendor": { "name": "Anthropic", "slug": "anthropic" },
      "summary": "Added new tool-use documentation section...",
      "significance": 4,
      "categories": ["documentation", "api-update"],
      "created_at": "2026-02-28T06:00:00.000Z"
    }
  ]
}

Example response

GET /api/v1/feed — free tier (no auth)

{
  "_meta": {
    "service": "jadecli llms.txt feed",
    "version": "0.2.0",
    "vendor_count": 5,
    "tier": "free",
    "updated_at": "2026-02-28T12:00:00.000Z"
  },
  "feed": [
    {
      "vendor": {
        "name": "Anthropic",
        "slug": "anthropic",
        "domain": "platform.claude.com",
        "category": "ai-platform"
      },
      "latest": {
        "content_hash": "a1b2c3...",
        "byte_size": 1024,
        "line_count": 42,
        "link_count": 15,
        "fetched_at": "2026-02-28T06:00:00.000Z"
      },
      "recent_change": null
    }
  ]
}

Access tiers

Tier	Price	Requests/day	Diffs	History
free	Free	100	No	7 days
starter	$29/mo	5,000	Yes	90 days
pro	$99/mo	50,000	Yes	365 days
enterprise	$499/mo	500,000	Yes	730 days
enterprise_plus	$999/mo	-1	Yes	-1 days

OpenAPI spec not found at /openapi.json

Try the feed endpoint View pricing