Connect Venon to ChatGPT or Claude in about 1 minute. Once connected, you can ask questions using your real store data instead of copying numbers into the chat.

Use the AI Connector for ChatGPT, Claude, or Cursor.
Use the Public API for custom dashboards, spreadsheets, reports, and other tools.

You manage both in Venon under Settings → AI & API. Admins, editors and viewers can open AI & API and create API keys for their shop. Editors can grant read, cost-write and ads-write permissions; viewers can grant read permissions only. Non-admins can manage only credentials they created. Each AI Connector can access 1 shop. Create a separate connector for each additional shop.

Numbers differ from your dashboard? The API and the AI Connector use Last Paid Click with a Lifetime window unless you ask for something else. The Venon dashboard starts on All Clicks. Tell the AI which model to use, for example “Use All Clicks”, or pass attribution_model in API requests to match the dashboard. When comparing POAS, also check whether the result uses profit before or after ad spend.

What you can ask

“Which Meta campaigns made the most profit in the last 30 days?”
“Show revenue, ad spend, and profit by channel.”
“Which products are missing costs?”
“What should I scale, stop, or test next?”
“Pause the 3 Meta ad sets with the lowest ROAS.” (needs the Ads (Write) permission)

You can also choose an attribution model and window, for example: “Use last paid click with a 7-day window.” The available models are First Click, Last Click, Last Paid Click, Linear Paid, Linear All, and All Clicks. The windows are 1, 7, 14, 28, and 90 days, or Lifetime.

Connect Claude

Open Claude and click Plus.
Click Connectors, then Manage Connectors.
Click Add Custom Connector.
Enter Venon as the name.
Enter this connector URL:
```
https://developer.venon.io/mcp
```
Leave the other fields empty and click Add.
Sign in to Venon. Pick the shop under Grant access to shop, tick the permissions you want to give, and click Authorize.

Test the connection by asking: “Which Meta campaigns made the most profit in the last 7 days?”

Venon onboarding Claude setup and separate AI connections for multiple shops

Connect ChatGPT

Open ChatGPT settings.
Go to Apps.
Open Advanced settings and turn on Developer mode.
Create a new app and name it Venon.
Choose MCP as the connection type.
Enter this server URL:
```
https://developer.venon.io/mcp
```
Sign in to Venon. Pick the shop under Grant access to shop, tick the permissions you want to give, and click Authorize.

Select the Venon app in ChatGPT, then ask a question about your store.

Connect Cursor

Open Cursor Settings → Tools & Integrations.
Click New MCP Server.

Add this configuration:

{
  "mcpServers": {
    "Venon": {
      "url": "https://developer.venon.io/mcp"
    }
  }
}

Save the file and enable the server.
Click Login, then sign in to Venon, pick the shop, tick the permissions, and click Authorize.

Venon onboarding Cursor setup with the MCP server configuration

Permissions

When you connect an AI assistant or create an API key, you choose what it may do. There are 5 permissions:

Analytics (Read) (analytics:read): read analytics and dashboard data, such as channel, campaign, ad set, and ad performance.
Orders (Read) (orders:read): list orders and read their financial and cost breakdowns. The API provides GET /v1/orders and GET /v1/orders/:id; the AI Connector provides list_orders and get_order_cost_breakdown.
Cost settings (Read) (cost:read): read product costs (COGS), shipping costs, and payment fees.
Cost settings (Write) (cost:write): create and update product costs, shipping costs, and payment fees. Admins and editors can grant this.
Ads (Write) (ads:write): Pause and activate campaigns, ad sets/ad groups and ads on Meta and Google Ads. Change daily campaign budgets on Meta and Google Ads, and daily ad-set budgets on Meta. Google ad groups do not support direct budget changes; update their campaign budget instead. Only admins and editors can grant this.

Ads (Write) makes real changes. When an AI or tool pauses an ad or changes a budget, the change goes to Meta or Google Ads right away. Budgets are daily budgets in your ad account currency. If a Google campaign uses a shared budget, changing that budget affects every campaign that shares it. Only give this permission if you want the AI to manage your ads, and check what it plans to change before you confirm.

Only give each connection the access it needs.

Connect multiple shops

Each AI Connector can access 1 shop. To use the same AI assistant with more shops, add a separate connector, app, or MCP server for each shop.

Use this URL for the first shop:
```
https://developer.venon.io/mcp
```

Use this URL for the second shop:

https://developer.venon.io/mcp/connections/2

Use this URL for the third shop:

https://developer.venon.io/mcp/connections/3

For each additional shop, increase the final number. Continue through /connections/10 for the tenth shop.
Complete the Venon sign-in for each connection and choose the shop it should access.

Name each connection after its shop so it is easy to select the right one.

Manage or disconnect an AI assistant

In Venon, go to Settings → AI & API.
Under AI Assistants, find the assistant in Active connections.
Click the trash icon, then Revoke. Its access stops immediately.

AI Assistants card in Venon Settings with 1 active Claude connection, its scopes, Connected, Last used, and Expires dates, and a trash icon

The table shows each connected app, the permissions (scopes) it has, when it was connected, when it was last used, and when it expires.

When an AI connection expires

AI connections use tokens with an expiry date. Using a connection does not itself extend that date. If your AI assistant supports token refresh, it can renew access while its refresh token is valid. If the connection expires or cannot refresh, reconnect the assistant and approve access again. Check the expiry shown in AI & API.

Use the Public API

Use the Public API when you want Venon data in another system, such as a spreadsheet, BI tool, scheduled report, or custom dashboard.

Create an API key

Go to Settings → AI & API.
Under API Keys, click Create API Key.
Enter a Name, such as Nightly report or Internal dashboard.
Under Scopes, tick the permissions the key needs. See Permissions.
Under Expiration, choose Never expires, 7 days, 30 days, or 90 days.
Click Create Key, then copy the key.

Create API Key dialog with the Name field, the 5 scope checkboxes, and the Expiration dropdown set to Never expires

The dialog lists all 5 scopes with a short description of each. The Expiration dropdown is set to Never expires by default.

Important: Venon shows the full key only once. If you lose it, delete it and create a new one.

When a key expires, requests with it return 401 Unauthorized. Create a new key to continue.

API documentation

Full documentation: developerdocs.venon.io
Base URL: https://developer.venon.io
Default limit: 60 requests per minute for each key.
Ads write requests (pause, activate, budget changes): 10 requests per minute for each key.
Analytics requests use last_paid_click and lifetime by default. Set attribution_model and attribution_window to match the view you use in the dashboard.

Manage API keys

See your keys under Settings → AI & API in Your API Keys.
Click the trash icon to revoke a key immediately.
In the Settings interface, create a replacement key with the permissions you need, update the tools that use it, and revoke the old key.

API Keys card listing 3 keys with their masked key, scopes, expiry date, last used time, and a trash icon

Each row shows the key name, the first characters of the key, its scopes, when it expires (Never or a date), and when it was last used.

Keep access secure

Treat API keys like passwords.
Only give each connection the access it needs.
Set an expiry on keys you only need for a while.
Remove connections and keys you no longer use.
Check values before allowing a tool to update cost data, pause ads, or change budgets.

Troubleshooting

I can’t find AI & API: admins, editors and viewers can open this page for a shop they have access to. Check that you have selected the correct shop.
The assistant can’t see data: disconnect it, reconnect it, and make sure you choose the correct shop.
The assistant stopped working after a break: The access token may have expired or the assistant may have been unable to refresh it. Reconnect the assistant and approve access again.
The assistant can read data but can’t update costs: reconnect it and allow cost settings changes. Admins and editors can grant this.
The assistant can’t pause ads or change budgets: reconnect it and allow ads changes. Only admins and editors can grant this.
401 Unauthorized: the key is missing, incorrect, expired, or revoked.
403 Forbidden: the key does not have the access required for that action.
429 Too Many Requests: wait briefly, then try again.
The numbers don’t match the dashboard: the API and AI Connector use Last Paid Click by default, while the dashboard starts on All Clicks. Ask for the same attribution model and window you use in the dashboard, and check the selected shop.

Need help? Contact Venon support and we’ll help you connect your tool.

Connect Venon to ChatGPT, Claude, and Other Tools