Connect MentionFox to a Custom GPT via the OpenAPI actions schema. Once connected, the GPT can call MentionFox tools on your behalf — researching people, scanning for mentions, comparing subjects, and running vetting reports — all from a natural chat interface. Setup takes about five minutes.
Get your API key
All integrations
What this integration enables
After connecting MentionFox to ChatGPT as a Custom GPT, you can ask the GPT to run any of the following actions directly from the chat window:
Scan for mentions
Find brand mentions across 55+ platforms 3cr/source
Research a person
Enrich a contact with professional details 5cr
Get a dossier
Full person dossier from your saved profiles 30cr or cached free
Compare people
Side-by-side comparison across dimensions 5cr/profile
Score intent
Rate a post for buyer intent 0-100
Find journalists
Find journalists who cover a topic 10cr
Save to pipeline
Add a person to your Foxhole pipeline free
Get recent research
Retrieve your recently enriched profiles free
Credits are consumed from your MentionFox account balance when the GPT calls paid tools. Free-tier tools have no credit cost. See pricing for plan credit grants.
Setup instructions
Get your MentionFox API key
Go to Settings in your MentionFox dashboard, open the MCP and API tab, and copy your API key. If you do not have one, generate a new key from that page.
Open the Custom GPT editor in ChatGPT
Log into ChatGPT. Click "Explore GPTs" in the sidebar, then click "Create" in the top right. This opens the GPT editor. Fill in a name and description for your MentionFox GPT — something like "MentionFox Research Assistant."
**
Add a new action**
In the GPT editor, click "Configure," then scroll to "Actions" at the bottom of the panel and click "Create new action." This opens the action schema editor.
Paste the MentionFox actions schema URL
In the schema field, import from URL. Use:
https://mentionfox.com/api/openapi.json
This loads the OpenAPI schema that defines all available MentionFox tools with their input parameters and response shapes.
Configure authentication
Set the authentication type to "API Key." Set the auth type to "Bearer." Paste your MentionFox API key into the key field. The GPT will include this as a Bearer token in every request it makes to MentionFox.
Save and test
Click "Save" in the GPT editor. Open a new conversation with your MentionFox GPT and ask it to "find recent mentions of [your brand] on Reddit." If the setup is correct, it will call the scan tool and return results in the chat window.
Using the MCP server instead
If you are using a client that supports the Model Context Protocol rather than Custom GPT actions — Claude Desktop, Cursor, or Cline — connect to the MentionFox MCP server directly instead of using the actions schema.
The MCP server URL is:
https://wnzxffwiiubqvcvnnjbz.supabase.co/functions/v1/mentionfox-mcp
Add this URL as an MCP server in your client's configuration, with your MentionFox API key as the Bearer token. The tools available via MCP are the same as via the Custom GPT actions schema. See the MCP settings page for connection instructions tailored to each client.
How credits work with the integration
Every tool call made through the Custom GPT or MCP server is authenticated using your API key and charges credits to your MentionFox account balance. Free-tier tools (save to pipeline, get recent research, clarify research intent) do not consume credits. Paid tools consume credits at the same rate as calling them from the dashboard directly.
**You can monitor API usage from the MCP settings page in your dashboard. **The usage log shows tool names, call counts, and credits consumed over the last 30 days, broken down by tool. This lets you understand whether heavy research via the Custom GPT is drawing down your monthly credit grant faster than expected and whether you need to adjust your plan.
There is no separate API pricing tier. Every MentionFox plan includes API and MCP access. Credit costs per tool are the same regardless of whether you call a tool from the dashboard or from a connected GPT or MCP client.
Top comments (0)