AgenticSource API.

Quickstart.

Four steps to a working integration. Total time: about 30 seconds.

1. Sign up

Magic-link signup at agenticsource.dev/signup. Email only, no credit card required for the free tier.

2. Get your endpoint

Every account uses the same MCP endpoint:

https://agenticsource.dev/mcp

3. Configure your agent

Drop the MCP URL into your agent's configuration. For managed clients (Claude, ChatGPT, Codex) authenticate via OAuth. For local clients (Cursor, Continue, Cline, Zed, Windsurf) paste your API key. Full client-specific setup in Client setup.

4. Call any tool

Your agent now has 13 new tools available. The agent-side call (in pseudocode your AI client handles for you):

await mcp.search_images({
  query: "team meeting modern office",
  orientation: "landscape",
  commercial_safe_only: true
})

Under the hood, the MCP client sends a JSON-RPC 2.0 request over HTTP. If you're integrating directly without an MCP client, the wire format is:

POST https://agenticsource.dev/mcp
Authorization: Bearer sk_as_...
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_images",
    "arguments": {
      "query": "team meeting modern office",
      "orientation": "landscape",
      "commercial_safe_only": true
    }
  }
}

Authentication.

Two paths supported. Pick whichever your client speaks.

OAuth 2.0 + PKCE

For managed AI clients (Claude, ChatGPT, Codex). Standard OAuth 2.0 with PKCE per RFC 7636 and discovery metadata per RFC 8414.

• Discovery URL: https://agenticsource.dev/.well-known/oauth-authorization-server
• Authorization endpoint: /oauth/authorize
• Token endpoint: /oauth/token
• Scopes: tools:read, tools:write

Your client handles the handshake. You click "Connect AgenticSource" inside the AI client; the magic-link flow signs you up if needed; the AI client receives an access token; from then on, all MCP calls are authenticated by header.

API key (Bearer)

For Cursor, scripts, and local MCP clients that don't support OAuth. Generate a key in the dashboard (agenticsource.dev/dashboard), then send it as a Bearer header:

Authorization: Bearer sk_as_XXXXXXXXXXXXXXXXXXXXXXXX

API keys are scoped to a single account and rotate freely. The dashboard supports up to 10 active keys per account.

Client setup.

Drop-in configuration for the eight officially-tested MCP clients.

Tools.

13 MCP tools across 11 visible categories plus two legacy categories still callable through the API.

{
  "count": 35,
  "results": [{
    "source": "unsplash",
    "id": "...",
    "url_full": "https://...",
    "url_thumbnail": "https://...",
    "photographer": "J. Doe",
    "photographer_url": "https://...",
    "license_name": "Unsplash License",
    "license_url": "https://...",
    "commercial_use": true,
    "attribution_required": false,
    "width": 5472,
    "height": 3648
  }],
  "sources_responded": ["unsplash", "pexels", "pixabay", "openverse"]
}

{
  "tools": [
    {
      "name": "search_images",
      "category": "photos",
      "sources": ["unsplash","pexels","pixabay","openverse","wikimedia","nasa","met"],
      "status": "operational"
    },
    ...
  ]
}

License model.

Every search result carries four normalized license fields, regardless of source:

Common license types you'll see

• CC0: public domain, no restrictions. Examples: Poly Haven, parts of OpenVerse.
• CC-BY: free to use commercially, attribution required.
• CC-BY-NC: non-commercial only. Filtered out by commercial_safe_only: true.
• Unsplash License: free commercial use, no attribution required (though appreciated).
• Pexels License: similar to Unsplash; free commercial use, no attribution.
• Pixabay License: free for most commercial use with some restrictions (no selling without modification).

Rate limits & quotas.

Per-minute rate limits

Monthly quotas

Soft-capped plans never silently fail. At 80% of quota you receive a dashboard banner and email warning. At 100% your agent gets a structured response with a one-click boost-pack purchase link. With auto-buy enabled (Pro and Stock+ setting), boost packs purchase automatically up to your configured monthly max-spend cap (default $50).

Pagination

Search tools return up to 50 results per call. Cross-source tools merge and rank results internally before returning. For deeper pagination, pass offset in the request:

await mcp.search_images({ query: "...", limit: 35, offset: 35 })

Note: deep pagination beyond ~200 results is not recommended; relevance scores drop off sharply across all upstream sources.

Caching

Identical queries are served from Cloudflare KV cache for 24 hours (search), 7 days (icon/font lookups), or 30 days (3D/HDRI/textures, which rarely change). Cache hits return in under 50ms and do not count against any upstream rate limit.

Errors.

AgenticSource follows JSON-RPC 2.0 error response shape. Standard MCP error codes plus a few application-specific ones.

Self-host.

The AgenticSource server is MIT-licensed and runs on Cloudflare Workers, D1, and KV. Full source on GitHub.

What you need

• A Cloudflare account with Workers, D1, and KV enabled.
• Upstream API keys: Unsplash, Pexels, Pixabay, Freesound, Google Fonts (free tiers cover the basics).
• Optional: Stripe account if you want to run a paid product on top of self-hosted.

Deploy

git clone https://github.com/agenticsource/agenticsource
cd agenticsource
npm install
npx wrangler login
npx wrangler d1 create agenticsource-db
npx wrangler kv:namespace create CACHE
# paste returned IDs into wrangler.toml
npx wrangler d1 execute agenticsource-db --remote --file=schema.sql
# set secrets for each upstream
npx wrangler secret put UNSPLASH_ACCESS_KEY
npx wrangler secret put PEXELS_API_KEY
# ... etc
npm run deploy

Each tool source is in src/sources/ as its own file, so removing or replacing a category is a one-file change.