You will learn#
The Attribuly Model Context Protocol (MCP) server seamlessly integrates with Attribuly’s APIs, enabling AI clients to interact with your Attribuly data. This guide will walk you through configuring various MCP clients for both the remote-hosted MCP server (recommended) and the local MCP server.MCP (Model Context Protocol) is an open protocol that helps AI models securely interface with different data sources and tools. You’ll connect Attribuly’s MCP server to an MCP client, i.e., an AI agent like Claude or Cursor, to get assistance with your Attribuly data. Your MCP client can help with a variety of tasks from campaign creation to performance reports. Here are some examples of prompts you can give:Show me the performance of my campaigns from the last 30 days.
Which campaign are performing the best in terms of conversions?
Configuration#
2.
For authentication, please use your API key. For details, refer to the API Authentication Guide.
Claude Code CLI#
Claude Code Desktop#
2.
Open Claude Desktop. Within Settings > Developer > Edit Config, add the following, substituting your API key and MCP server address:
{
"mcpServers": {
"attribuly": {
"type": "http",
"url": "https://data.api.attribuly.com/mcp",
"headers": {
"ApiKey": "your-api-key"
}
}
}
}
4.
Once you have saved all configuration changes, terminate all Claude processes and relaunch Claude to apply the new settings.
5.
Verify the connection by looking for visual indicators and asking a question to test the connection.
Cursor#
2.
Open Cursor. Within Settings > Cursor Settings > Tools & Integrations > Add Custom MCP, add the following, substituting your API key and MCP server address:
{
"mcpServers": {
"attribuly": {
"type": "http",
"url": "https://data.api.attribuly.com/mcp",
"headers": {
"ApiKey": "your-api-key"
}
}
}
}
4.
Once you have saved all configuration changes, terminate all Cursor processes and relaunch Cursor to apply the new settings.
5.
Verify the connection by looking for visual indicators and asking a question to test the connection.
VS Code#
2.
Open VS Code. Within settings (Ctrl + Shift + P > Preferences: Open Settings (JSON)), add the following, substituting your API key and MCP server address:
{
"mcp": {
"servers": {
"attribuly": {
"type": "http",
"url": "https://data.api.attribuly.com/mcp",
"headers": {
"ApiKey": "your-api-key"
}
}
}
}
}
4.
Once you have saved all configuration changes, terminate all VS Code processes and relaunch VS Code to apply the new settings.
5.
Verify the connection by looking for visual indicators and asking a question to test the connection.
ChatGPT#
1. Enable Developer Mode#
1.
Open ChatGPT (web/desktop app).
2.
Navigate to Settings → Apps & Connectors.
3.
Under the Advanced section, toggle Developer Mode to enabled.
2. Create Connector#
1.
In Settings → Connectors, click the Create button.
2.
Fill in the configuration form:Server URL: https://data.api.attribuly.com/mcp
Check the box: I trust this provider
Add authentication (ApiKey)
3.
Click Create to finish connector setup.
Note: Without Developer Mode enabled, ChatGPT will reject the server if it lacks search/fetch tools. With Developer Mode on, search/fetch tools are not required for Chat mode usage.
3. Use in Chat#
1.
Start a new chat conversation in ChatGPT.
2.
Click the + button → select More → choose Developer Mode.
3.
Enable your MCP server connector (critical: the connector must be explicitly added to each chat session).
4.
Now you can use the tools provided by your MCP server in the chat.
| Tool Name | Description |
|---|
| get_all_attribution_data | Get omnichannel attribution report data |
| get_ad_attribution_data | Get ad attribution report data |
| get_product_analysis_data | Get product analysis report data |
| get_influencer_data | Get influencer attribution report data |
| get_link_builder_data | Get custom tracking link attribution report data |
Getting Started#
2.
Get your private API key from Settings > API Keys
3.
Configure your MCP client following the instructions above
4.
Start using your MCP client
Modified at 2026-03-19 10:45:54
