Venon gives you 2 read-only ways to use your data outside the dashboard: the Public API and the MCP server.
Public API: pull Venon analytics into scripts, spreadsheets, BI tools, or custom dashboards.
MCP server: connect AI assistants like Claude, ChatGPT, and Cursor so you can ask questions about your Venon data in plain language.
Use the API for automated reports, syncs, exports, or dashboards. Use MCP when you want to chat with your data inside an AI assistant.
Both are managed in Settings → API & MCP, require admin access, and are read only today.
Public API
Best for developers, analysts, and technical teams.
Use it when you want Venon analytics in another system.
Common uses include custom reporting dashboards, spreadsheet exports, BI tool syncs, scheduled scripts, and internal reports.
Create an API key
Go to Settings → API & MCP.
In API Keys, click Create API Key.
Name the key clearly, for example Looker Studio, Nightly export, or Internal dashboard.
Choose the scopes and expiration.
Click Create, then copy the key immediately.
Important: the full API key is only shown once. If you lose it, delete the key and create a new one.
Scopes
Analytics (Read) (analytics:read): read analytics and dashboard data. This powers the endpoints that are live today.
Orders (Read) (orders:read): reserved for order data endpoints coming soon.
API docs
Full endpoint docs: https://developerdocs.venon.io/
API base URL: https://developer.venon.io
Send your key as Authorization: Bearer vnon_your_key_here or X-API-Key: vnon_your_key_here.
Manage keys
API keys are listed in Settings → API & MCP with name, prefix, scopes, expiration, and last-used time.
To revoke a key, click the trash icon. Revoking takes effect immediately.
Scopes cannot be edited after creation, so create a new key if permissions need to change.
MCP
Best when you want to ask questions about Venon data in an AI assistant.
Works with compatible assistants that support remote MCP servers and OAuth.
Example questions:
“What was my ROAS by channel for the last 30 days?”
“Show me Meta ad spend and net profit for May.”
“Which ad sets drove the most first-time customers last week?”
You can also specify attribution settings, for example: “Use last paid click with a 7 day window.”
Connect ChatGPT
Open Settings → Connectors in ChatGPT and click Create.
Use Name: Venon, Description: Access Venon analytics and dashboard data, MCP Server URL: https://developer.venon.io/mcp, Authentication: OAuth.
Complete the OAuth flow and select the Venon connector in chat.
Connect Cursor
Open Cursor Settings → Tools & Integrations.
Click New MCP Server.
Add this MCP config:
{
"mcpServers": {
"Venon": {
"url": "https://developer.venon.io/mcp"
}
}
}Save the file, enable the server, click Login, and complete OAuth.
Manage MCP connections
Active AI assistant connections appear under MCP Connections in Settings → API & MCP.
To disconnect an assistant, click the trash icon. Access is revoked immediately.
Security best practices
Read only: API keys and MCP connections can read analytics data but cannot change your account.
Admin only: only admins can create keys or connect assistants.
Keys are shown once: treat API keys like passwords.
Use the right scope: give each key only the access it needs.
Revoke unused access: remove keys or connections you no longer use.
Troubleshooting
I can’t find API & MCP: this section is admin only.
No API keys are listed: create a key, and make sure you are viewing the correct shop/account.
401 Unauthorized: the key is missing, mistyped, expired, or revoked.
403 Forbidden: the key does not have the required scope. Analytics endpoints need Analytics (Read).
429 Too Many Requests: wait for the time shown in the Retry-After header.
Numbers don’t match: check the attribution model and attribution window.
AI assistant can’t see data: revoke the MCP connection, reconnect it, and confirm you selected the correct account.
Need help connecting the API or MCP server? Reach out to support and we’ll walk you through it.