Your agent works
here too.
Connect Claude, Cursor or any MCP client to the hosted Fovea server with an API key. It searches the same library, reads the same numbers, and builds collections with the write scope you give it.
Settings
MCP server
Ask Claude, Cursor or any MCP client about this workspace's creatives, products and ad performance.
https://api.foveahq.com/mcpAuthenticate with an API key from this page: Authorization: Bearer fov_.... The server only sees Acme Watches, with the key's access.
Claude Code: run once, then ask about your creatives.
claude mcp add --transport http fovea https://api.foveahq.com/mcp \ --header "Authorization: Bearer fov_your_key"
| Tool | What it does | Access |
|---|---|---|
whoami | Workspace, scopes, money visibility. | Read |
search_assets | Search the creative library. | Read |
get_asset | One creative with analysis, links and performance. | Read |
top_creatives | Rank creatives by spend, ROAS, CTR, impressions. | Read |
list_collections | Collections with asset counts. | Read |
create_collection | Create a collection (optionally with assets). | Write |
“Which three creatives had the best ROAS this month?”
> Which three creatives had the best ROAS this month?
fovea · top_creatives(metric="roas", days=30, limit=3)
1. ugc-maya-field40-gift 3.42x
2. motion-diver42-freeshipping 2.64x
3. ugc-sam-chrono39-wrist 1.71x
> Put them in a collection called "October winners".
fovea · create_collection(name="October winners",
asset_ids=["6a1f0c1e-...", "...", "..."])
Done. "October winners" has 3 creatives.Ten tools, real arguments.
Every tool runs the same workspace-scoped code as Ask Fovi and the REST API, so tenant isolation and money gating are the same everywhere.
Every tool, every argument.
The full list, as the server describes itself. Arguments marked ? are optional.
whoamisearch_assetsget_assettop_creativeslist_collectionscreate_collectionadd_to_collectionlist_productsget_productads_summaryAPI keys
Let scripts, Zapier, Claude or Cursor read this workspace through the Fovea API and MCP server.
| Key | Access | Prefix | Last used |
|---|---|---|---|
| Claude Code | ReadWrite | fov_Qm3x8sLp... | 4m ago |
| Monday winners report | ReadMoney | fov_7TnVb2Kd... | 2d ago |
| Zapier | Read | fov_Hc9wE1rZ... | 1h ago |
https://api.foveahq.com/api/v1/publicMoney stays gated, even for agents.
Spend, revenue and ROAS reach an agent only on a key with the Money scope, which only an Admin can add. Without it, money fields are left out and revenue_visible is false.
Connect in one command.
Streamable HTTP at api.foveahq.com/mcp. A bearer API key from Settings > Integrations. Included on every paid plan.
claude mcp add --transport http fovea https://api.foveahq.com/mcp \ --header "Authorization: Bearer fov_your_key"
{
"mcpServers": {
"fovea": {
"url": "https://api.foveahq.com/mcp",
"headers": {
"Authorization": "Bearer fov_your_key"
}
}
}
}{
"mcpServers": {
"fovea": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.foveahq.com/mcp",
"--header",
"Authorization:${FOVEA_AUTH}"
],
"env": {
"FOVEA_AUTH": "Bearer fov_your_key"
}
}
}
}Questions, answered.
Developer docs live at /docs: MCP server, API keys, public API and webhooks.
Which plans include the MCP server?+
Every paid plan: Starter, Growth, Agency and Enterprise. It is not available during the free trial.
How does my agent authenticate?+
With a workspace API key as a bearer token: Authorization: Bearer fov_... Admins create keys in Settings > Integrations. A key is shown once; Fovea keeps only a one-way hash.
Which clients work?+
Any client that speaks MCP over streamable HTTP with a custom header. Claude Code and Cursor connect directly; Claude Desktop connects through the mcp-remote bridge. The setup page has copy-paste config for all three.
Can an agent change my library?+
Only collections, and only with a key that has the Write scope: it can create collections and add assets to them. With a read-only key the tool call returns an error and nothing changes. Tagging and uploads stay in the app.
Does an agent see revenue?+
Only with the Money scope, which only an Admin can add, and only while the key's creator still has a role that sees money. Otherwise money fields are left out and revenue_visible is false.
Is there a rate limit?+
120 requests a minute per key, with X-RateLimit headers on every response, and up to 25 active keys per workspace.
Point your agent
at your ads.
Start a plan, create an API key in Settings, and ask Claude which creatives made money.
Start free- 14-day free trial
- No card
- No ad-spend caps