One API for Agents docs
One API for Agents is a connection broker and data layer for AI agents. A workspace holds connected accounts (Google Search Console, Google Analytics 4 and Bing Webmaster Tools today; DataForSEO next). Your agents reach every one of them through one REST API and one OAuth-enabled remote MCP server.
It is a wrapper: each call is proxied to the provider when your agent makes it, then logged with its request, response, latency and cost. Nothing is synced in the background and no website is monitored.
Start here
- Quickstart: sign in, connect an account, make your first call.
- MCP setup: connect Claude, Claude Code, Codex, Cursor or any MCP client.
- REST API: authentication,
POST /v1/calland the other endpoints. - Connect links: let clients connect their own Google accounts.
- Caching with max_age: reuse a recent response instead of calling the provider again.
- Errors: every error code and what to do about it.
Providers
- Google Search Console: Clicks, impressions, queries, URL inspection and sitemaps.
- Google Analytics 4: Traffic, landing pages and engagement from the Data API.
- Bing Webmaster Tools: Queries, pages, rank and traffic, and crawl health from Bing.
- Google Sheets: Read, append and update spreadsheet rows; create new sheets.
- Google Docs: Read Google Docs as markdown, create them, and append, insert or replace text.
- DataForSEO (coming soon): SERPs, keywords and backlinks, metered per call.
Concepts
| Concept | What it is |
|---|---|
| Workspace | Your team's account. Holds connections, clients, members, API keys and call logs. |
| Connection | One connected account at a provider, such as a Search Console login. Credentials are encrypted and never returned. |
| Client | Optional. A customer of your agency. Connections can belong to a client, and members, keys and agents can be limited to some clients. |
| Connect link | A link you send to a client so they can connect their own accounts, with no password sharing and no sign-up. |
| Raw endpoint | A passthrough to one provider API call, such as searchanalytics.query. Input is validated before it is sent. |
| Smart tool | A curated call with compact output for agents, such as gsc_top_queries. |
| API key | A bearer token (oa_…) for scripts and servers. Read-only or read-write, and limited to the creator's clients. |
| MCP grant | What an agent gets when you approve it over OAuth: a workspace, read-only or read-write, and the clients it can see. |
| Call log | One record per call with the redacted request and response, status, latency and cost. |
For agents
These docs are also available as plain markdown. Append .md to any docs or provider URL (for example /docs/quickstart.md), or read /llms.txt for an index and /llms-full.txt for everything on one page.