1. Attribuly MCP Server
Attribuly Developers
  • Public API
    • API Authentication Guide
    • Attribution
      • All
        • Get attribution report
        • Get total numbers
        • Querying orders by a campaign
      • Ads
        • Channel/Campaign/Ad-set/Ad level ads attribution
        • list all customer level details
        • Customer level report for a specific campaign
      • Product analytics
        • List product analytics
        • List total data for product analysis
        • Attribution report for a single product
        • Total attribution report for a single product
      • Web Analytics
        • Web Analytics
        • Get total numbers
    • Tracking links
      • Influencer
      • Link Builder
    • Store
      • Customer journey of an order
      • Order First & Last Touchpoint of an order
      • Event summary of a landing page
    • Setting
      • Attribution models
      • Conversion Goals
    • Connections
      • List Source
      • List Destination
  • Push data to Attribuly
    • Quick Start
    • Events
      • Page viewed
      • Cart viewed
      • Product viewed
      • Collection viewed
      • Search submitted
      • Product added to cart
      • Product removed to cart
      • Lead form
      • Checkout started
      • Payment info submitted
      • Checkout completed
      • Checkout address info submitted
      • Checkout contact info submitted
      • Checkout shipping info submitted
      • Basic
        • Checkout
        • Context
        • Document
        • MailAddress
        • Navigator
        • Window
    • Store
      • Order
      • Customers
      • Products
  • Attribuly MCP Server
    • MCP Configure
  • Schemas
    • Push Identity events to Webhook
      • Active On site - Attribuly SS
      • Viewed Product - Attribuly SS
      • Collection View - Attribuly SS
      • Added to Cart - Attribuly SS
      • Checkout Started - Attribuly SS
      • Subscribe - Attribuly SS
  1. Attribuly MCP Server

MCP Configure

Connect your store with ChatGPT, Codex or Claude: sign in to Attribuly, choose your store and approve read-only access.

Settings to use#

FieldValue
NameAttribuly
Server URLhttps://data.api.attribuly.com/mcp
Connection type, if requestedStreamable HTTP
AuthenticationOAuth
No plugin ZIP, API key or client secret is needed.

1. ChatGPT#

1.
Open Plugins → Add → Add custom MCP server.
2.
Enter the name and server URL above. Choose OAuth if asked.
3.
Review the notice and click Create or Create as a plugin.
4.
Click Connect / Sign in. Log in to Attribuly, choose your store, review the permissions and click Allow access.
5.
Return to ChatGPT. Start a new chat and select Attribuly from the plugin picker or @ menu.
If the form requires an OAuth Client ID, enter:
https://chatgpt.com/oauth/client.json
Leave Client Secret and custom headers empty. This client ID is for ChatGPT only.
Official ChatGPT connection guide.

2. Codex desktop#

1.
Open Settings → MCP servers → Add server. If your version shows Plugins instead, choose Settings → Plugins → Add → Add MCP server.
2.
Enter Attribuly, select Streamable HTTP, and paste the server URL above.
3.
Leave Bearer token, headers and environment-variable fields empty. Click Save, then Restart if offered.
4.
Click Authenticate / Log in for Attribuly. In the browser, log in to Attribuly, choose your store, review the permissions and click Allow access.
5.
Return to Codex and start a new session. Ask it to use the Attribuly MCP connection.
Official Codex MCP guide.

3. Claude web or desktop#

1.
Open Customize → Connectors. In some versions, use Settings → Connectors.
2.
Choose Add → Add custom connector. Enter Attribuly and the server URL above.
3.
Continue with the detected OAuth settings. Choose Sign in now and Use Claude's published identity if those options appear. Leave custom headers empty.
4.
Click Add / Connect. Log in to Attribuly, choose your store, review the permissions and click Allow access.
5.
Return to Claude. Enable Attribuly in your conversation through + → Connectors or the connector picker.
For company accounts, an authorized administrator may need to add or allow the connector first.
Official Claude connector guide.

Available tools#

Ask in plain language; the assistant chooses the tools automatically.
ToolWhat you can query
get_store_profileConnected store, domain, timezone and currency.
get_attribution_modelsAttribution models available for your store.
get_all_attribution_dataAll-channel attribution summaries and rankings.
get_attribution_totalsOverall attribution metrics for a selected report.
get_ad_attribution_dataPaid-ad performance by channel, campaign, ad set or ad.
get_ad_attribution_detail_dataOrder-level attribution for paid advertising.
get_all_attribution_detail_dataOrder-level attribution across all channels.
get_product_analysis_dataProduct revenue, units, spend and ROAS.
get_product_campaign_breakdownCampaign and channel performance for a specific product.
get_web_analysis_dataWebsite users, sessions, purchases and revenue.
get_order_detailPurchased items, quantities, order amounts and payment status.
Access is read-only and subject to your store permissions and Attribuly plan. Order details may include customer names and email addresses. Review the requested permissions before authorizing.
If an add/connect option is missing or setup fails, contact support with the client name and error text. Do not share passwords or tokens. Menu labels may vary by client version and account.
Modified at 2026-10-16 07:44:53
Previous
Products
Next
Active On site - Attribuly SS
Built with