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 12 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.

https://agenticsource.dev/mcp

https://agenticsource.dev/mcp

{
  "mcpServers": {
    "agenticsource": {
      "url": "https://agenticsource.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk_as_YOUR_KEY_HERE"
      }
    }
  }
}

[mcp_servers.agenticsource]
url = "https://agenticsource.dev/mcp"

[mcp_servers.agenticsource.headers]
Authorization = "Bearer sk_as_YOUR_KEY_HERE"

{
  "mcpServers": {
    "agenticsource": {
      "transport": "http",
      "url": "https://agenticsource.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk_as_YOUR_KEY_HERE"
      }
    }
  }
}

{
  "agenticsource": {
    "url": "https://agenticsource.dev/mcp",
    "headers": {
      "Authorization": "Bearer sk_as_YOUR_KEY_HERE"
    }
  }
}

"context_servers": {
  "agenticsource": {
    "command": null,
    "url": "https://agenticsource.dev/mcp",
    "headers": {
      "Authorization": "Bearer sk_as_YOUR_KEY_HERE"
    }
  }
}

{
  "mcpServers": {
    "agenticsource": {
      "url": "https://agenticsource.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk_as_YOUR_KEY_HERE"
      }
    }
  }
}

Tools.

12 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).

Enterprise (multi-tenant, webhooks, sub-accounts).

Embedding AgenticSource for your own users? We can issue scoped API keys per end-user, surface per-sub-account usage in your dashboard, and send webhooks on usage milestones. This is part of the upcoming Enterprise plan and currently in preview.

Email hello@agenticsource.dev to discuss your use case.

Rate limits & quotas.

Per-minute rate limits

Monthly quotas

Hitting rate limits a lot? Email hello@agenticsource.dev and we can usually raise your bucket for a specific workload.

Errors.

AgenticSource follows JSON-RPC 2.0 error response shape. Each error has a code and a message you can show to the user.

See changelog for the latest tool list and source coverage.