MCP Server
Run your crypto campaigns
from your AI assistant
Connect Claude, ChatGPT, Cursor or any Model Context Protocol client to your Mintfunnel account. Launch and optimize ads, place press release orders, and read onchain attribution by asking for it. Every change is previewed before it happens.
What it is
Your ad account, as tools an assistant can use
MCP is the open standard for giving an AI assistant real tools instead of a browser tab. The Mintfunnel MCP server exposes your advertiser account as that tool set, running on the same services and the same permission checks as the dashboard. There is no second copy of the money logic, and no scraping of screens.
- One connection covers ads, PR, attribution and wallet reads
- Reads are instant, writes wait for your confirmation
- Spending is bounded by a cap you set per connection
- Included with every advertiser account, no extra charge
Without MCP
- Open the dashboard
- Export the numbers
- Read the charts yourself
- Click through every edit
With MCP
- Ask in plain language
- Get the analysis with the data
- Review one clear preview
- Confirm, and it is done
Same account, same rules, a much shorter path.
What it can do
Everything the dashboard does, in a sentence
The server ships a full tool catalogue across campaigns, performance, PR distribution, attribution and your wallet, plus guides and ready-made prompts the assistant can pull in on its own.
Campaigns
List and inspect campaigns, draft new ones from a landing page and a creative, adjust bids, budgets, geo, device and schedule targeting, then pause, resume, submit for review, or archive.
Performance and optimization
Pull totals, daily series, and device, OS, browser and geo breakdowns for any date range, then ask for rule-based findings: bids under the floor, budgets exhausting early, low CTR against your account average, publishers spending with no conversions.
PR distribution
Browse the publisher catalogue and packages with prices and turnaround, quote a bundle, check a release against the house guidelines before you submit, create the order, and pay for it from your wallet.
Onchain attribution
Register a site, get the tracking snippet, verify the install, add the onchain contracts you want watched, and read attributed conversions and ROAS back into the conversation.
Wallet
Check your balance, credits and transaction history, and get a card top-up link or USDC deposit instructions. The agent can spend from your wallet within its cap, but it can never add funds to it.
Guides and prompts
The server ships its own reference material: creative specs, press release guidelines, and ready-made prompts for launching a campaign, running a weekly performance review, optimizing a campaign, writing a release, and setting up attribution.
Nothing changes on the first call. The agent shows you the preview, you say yes, and only then does it happen.
Access levels
You decide how far the agent goes
Pick a level when you approve the connection, and change it later from the AI Agents page. Each connection carries its own level and its own cap.
Read only
Look, never change
The agent can see everything you can see: campaigns, performance, PR orders, attribution, wallet balance. It cannot change a single thing.
- Full read access
- No writes at all
- Best for reporting and analysis
Manage campaigns
Change, never spend
Adds drafting and editing: create drafts, change targeting and bids, pause, resume, archive, and set up attribution. It cannot commit money.
- Everything in Read only
- Create drafts and edit campaigns
- Cannot reserve or pay out funds
Manage and spend
Bounded by a daily cap
Adds the actions that commit wallet funds: launching campaigns, raising budgets, paying PR orders. Every one is capped by a daily limit you choose.
- Everything in Manage
- Launch, raise budgets, pay PR orders
- Daily cap you set, $500 by default
Setup
Where to find it, and how to connect
Everything lives on one page inside the platform. Sign in to Mintfunnel, and in the left sidebar under Account you will find AI Agents. That page holds your connection URL, per-client instructions, your connected agents, your agent keys, and the activity log.
- 1
Open Account, then AI Agents
Sign in at app.mintfunnel.co. In the left sidebar, under the Account section, click AI Agents. The page opens with your connection URL at the top, ready to copy.
- 2
Add the connection URL to your assistant
Paste it into your client as a custom connector or MCP server. The page carries exact steps for Claude, Claude Code, ChatGPT, Cursor, and anything else that speaks MCP over HTTP.
- 3
Approve the connection on Mintfunnel
Your assistant sends you back to Mintfunnel to sign in. On the consent screen you pick the access level, set the daily spend cap, tick the acknowledgement, and click Allow access.
- 4
Ask for your account overview
Back in the chat, start with something simple like "give me my Mintfunnel account overview" to confirm the tools are live. From there, campaigns, PR, and attribution are all one sentence away.
Your connection URL
https://app.mintfunnel.co/mcpClaude Code, in one command
claude mcp add --transport http mintfunnel https://app.mintfunnel.co/mcpThen run /mcp, pick mintfunnel, and choose Authenticate. Approve the connection in the browser tab that opens.
Claude
- 1Open claude.ai, go to Settings, then Connectors.
- 2Choose Add custom connector and paste the connection URL.
- 3Click Connect, sign in to Mintfunnel, and choose what the agent may do.
ChatGPT
- 1In ChatGPT open Settings, then Connectors (developer mode must be on for your workspace).
- 2Create a connector with the connection URL and OAuth authentication.
- 3Enable it in a chat and ask for your account overview.
Cursor
- 1Open Cursor Settings, then MCP, and add a new server.
- 2Set the type to HTTP and the URL to the connection URL.
- 3Click the server, choose Connect, and approve it in the browser.
Any other MCP client
- 1Any client that speaks MCP over Streamable HTTP with OAuth can connect to the same URL.
- 2If yours cannot do OAuth, create an agent key on the AI Agents page.
- 3Send that key as an Authorization: Bearer header instead.
For AI agents
An agent can set this up end to end
If you are an AI assistant reading this page on behalf of someone who wants to advertise on Mintfunnel, the runbook on the right is for you. It is the whole path from no account to a live, measured campaign, written as steps you can execute. Two of them need a human at the keyboard, and they are marked as such. Everything after the connection is yours to do through the MCP tools.
- Plain-text copy at mintfunnel.co/mcp.txt, no parsing required
- Every URL you need, stated exactly, none to guess
- The two human-only steps called out explicitly
- Verification checks so you know each step landed
Runbook: no account to live campaign
- 1
Create the account
HumanRegistration needs the person, since it sets an email and a password. Send them the link, then wait for them to confirm they are in.
https://app.mintfunnel.co/auth/register
- 2
Confirm the email
HumanMintfunnel emails a verification link. The account can sign in but cannot advertise until it is clicked.
check inbox, click verify
- 3
Connect this MCP server
AgentAdd the connection URL to your client. The person signs in on Mintfunnel and picks the access level and daily cap on the consent screen. Choose Manage and spend if you are expected to launch anything.
https://app.mintfunnel.co/mcp
- 4
Verify the connection
AgentCall get_account_overview. It returns the role, wallet balance, campaign counts, attribution status, your access level and the spend allowance you have left today. If it answers, you are live.
get_account_overview
- 5
Fund the wallet
HumanCall get_wallet_topup_instructions and hand back the card link or the USDC deposit details. An agent can never add funds, by design.
get_wallet_topup_instructions
- 6
Set up measurement first
AgentRegister the destination domain, hand the person the snippet for their head tag, then confirm it is reporting. Do this before spending so the first click is attributed.
add_attribution_site, verify_attribution_install
- 7
Build the campaign
AgentCreate it as a draft with the destination URL, budget, bid and targeting, plus an image_url that meets the creative spec. Read mintfunnel://creative-spec first if you are generating the creative.
create_campaign, mintfunnel://creative-spec
- 8
Launch it
AgentSubmit for review. This reserves budget, so it needs Manage and spend, and it returns a preview plus a confirmation token. Show the preview, get a yes, then call confirm_action.
set_campaign_status, confirm_action
- 9
Optimize on a schedule
AgentPull performance and the rule-based findings, then act on them. Each finding names the tool call that fixes it, so the loop closes without guesswork.
get_campaign_performance, get_campaign_recommendations
Guardrails
Built so an agent can never surprise you
Autonomy is useful right up until it spends money you did not agree to. Every part of the server is designed so that never happens.
Nothing changes on the first call
Every write tool returns a preview and a single-use confirmation token instead of acting. The agent has to show you what it plans to do and call confirm_action before anything moves.
A daily spend cap you control
Only a Manage and spend connection can commit wallet funds, never past the daily cap on that connection. Money-moving amounts are recomputed at confirm time, so if the cost grew since the preview the confirmation is refused.
Your account, and only your account
Tenancy comes from the token, never from what the model types. Every id is re-resolved through your own records and the same permission checks the dashboard uses. Publisher costs, moderation data, and other accounts are never in the output.
Everything is logged
Every call is recorded with the client, the tool, the arguments summary and the outcome, including calls that were blocked. You get an email when a new agent connects and when an agent commits a larger amount.
Your password is never shared
Connections use OAuth 2.1 with PKCE, so you sign in on Mintfunnel and approve the agent there. For clients that only support a bearer header, you can issue a scoped agent key instead, shown once and revocable.
Revoke in one click
Every connected agent is listed on the AI Agents page with its access level, daily cap, call count and last use. Revoking one cuts it off immediately and kills its tokens.
One thing to know: actions your assistant takes within the access you grant are taken on your behalf and are binding, exactly like actions you take in the dashboard. If you see something you do not recognize, revoke the agent and contact us.
Try it
Good first prompts
Paste one of these into your assistant once the connection is live.
Give me my Mintfunnel account overview.
Which of my campaigns should I fix this week, and why?
Draft a campaign for my new product page with a $500 budget and $25 a day, and show me the preview before launching.
Find PR placements under $800 indexed by Google News and quote me a bundle of three.
Set up attribution for example.com and tell me what to paste into the site.
Compare last week to the week before by geo and tell me where to cut spend.
FAQ
MCP server questions
It is an official Model Context Protocol server for Mintfunnel advertiser accounts. Connecting it to an AI assistant such as Claude, ChatGPT, Cursor or Claude Code gives that assistant a set of Mintfunnel tools, so you can run campaigns, read performance, place PR orders, and set up onchain attribution by asking in plain language instead of clicking through the dashboard.
Sign in at app.mintfunnel.co and look in the left sidebar under the Account section for AI Agents. That page holds your connection URL, per-client setup steps, your connected agents with their access levels and daily caps, your agent keys, and a log of recent agent activity. It is available to advertiser accounts.
It can read everything you can read, and depending on the access level you grant, create and edit campaigns, adjust bids, budgets, targeting and schedules, pause and resume, browse and quote PR placements, validate and submit a press release, pay a PR order from your wallet, register attribution sites, and read attributed conversions. It cannot add funds to your wallet, change your password, or see anything outside your account.
Nothing mutates on a first call. Write tools return a preview plus a single-use confirmation token, and the change only happens when you approve that specific action. Spending requires the Manage and spend level and is debited against a daily cap you choose, defaulting to $500. Amounts are recomputed at confirm time, so a cost that grew since the preview is refused rather than charged.
Copy the connection URL from Account, then AI Agents. In Claude, open Settings, then Connectors, choose Add custom connector, paste the URL, and click Connect. Claude sends you to Mintfunnel to sign in and pick the access level and daily cap for that connection. Approve it and the Mintfunnel tools appear in your chats.
Usually not. Connections use OAuth 2.1 with PKCE and dynamic client registration, which is what Claude, ChatGPT, Cursor and Claude Code expect, so you sign in on Mintfunnel and never paste a secret into the client. For clients that only support a bearer header, you can create a scoped agent key on the AI Agents page. Keys are shown once and can be revoked at any time.
Yes. Every call is written to an append-only activity log with the client name, the tool, a summary of the arguments, and the outcome, including calls that were blocked. Recent activity is listed right on the AI Agents page, you are emailed when a new agent connects, and you are emailed again when an agent commits a larger amount.
Open Account, then AI Agents, find the connection, and click Revoke. Access is cut immediately and the tokens behind it are revoked. You can also edit a live connection to change its access level or lower its daily cap without disconnecting it.
No. The MCP server is included with your Mintfunnel advertiser account. You pay for campaigns and PR orders exactly as you would in the dashboard, and connecting an assistant costs nothing on top.
Not yet. The first release covers advertiser accounts: campaigns, performance, PR distribution, attribution and wallet reads. A publisher-side server covering earnings, the approval queue and payouts is on the roadmap.
Give your assistant an ad account
Connect in about two minutes from Account, then AI Agents. Included with every Mintfunnel advertiser account.
Connect Your Assistant