Integration · ChatGPT Custom GPT

Use MentionFox tools directly inside ChatGPT.

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.

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 mentionsFind brand mentions across 55+ platforms 3cr/source
Research a personEnrich a contact with professional details 5cr
Get a dossierFull person dossier from your saved profiles 30cr or cached free
Compare peopleSide-by-side comparison across dimensions 5cr/profile
Score intentRate a post for buyer intent 0-100
Find journalistsFind journalists who cover a topic 10cr
Save to pipelineAdd a person to your Foxhole pipeline free
Get recent researchRetrieve 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

  1. 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.

  2. 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."

  3. 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.

  4. 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.

  5. 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.

  6. 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.

Connect MentionFox to ChatGPT

Get your API key from your settings page, then follow the setup steps above.

Get your API key