CitadexDocs

Use Citadex in ChatGPT and Claude (API & MCP)

Connect Citadex to Claude, ChatGPT, Cursor and other AI assistants in Settings → API & MCP: sign-in connections, permissions and monthly credit limits, advanced keys, what the assistant can read and do, the prompt library, and FAQ.

AI Assistant & API9 min read

What this is

MCP is the standard that lets AI assistants call outside tools. Once connected, you can ask about your Citadex data in plain language inside the Claude, ChatGPT, Cursor or Claude Code you already use, for example "How is my brand’s AI visibility this week?" or "Which prompts mention competitors but not us?". When you authorize it you choose read-only, or also let it re-check prompts, add prompts and draft articles; it always asks before spending credits.

Available on Pro and above. On Free the page shows Pro and above and Upgrade to Pro.

Where it is

User menu (bottom left) → Settings → API & MCP. From top to bottom:

  • Connection address: the one address every assistant uses, with Copy.
  • Connected apps: assistants connected by signing in, with their permission and credits this month.
  • Connect your AI assistant: tabs for Claude, ChatGPT, Cursor and Claude Code & others, each with steps.
  • Not sure what to ask? Start with the prompt library: featured ready-made prompts.
  • Keys (advanced): for tools that cannot sign in.

Settings → API & MCP: connection address, connected apps, connection steps

Settings → API & MCP: connection address, connected apps, connection steps

No key needed. You add a connector in the assistant, sign in to Citadex and choose the permission.

  1. 1

    Add it in Claude

    In Claude, open Settings → Connectors → Add custom connector, name it Citadex, paste the connection address and click Connect.

  2. 2

    Or add it in ChatGPT

    In ChatGPT, open Settings → Apps & Connectors → Advanced settings and turn on Developer mode. Choose Create, name it Citadex, paste the connection address and set authentication to OAuth. Requires a paid ChatGPT plan.

  3. 3

    Choose the permission on the Citadex page

    Read only (recommended): view data only; changes nothing and uses no credits. Read + actions: also re-check prompts, add prompts and generate article drafts.

  4. 4

    Set the limit and projects

    With Read + actions, fill in Monthly credit limit for this connection. Under Projects it can access, choose All projects (including team workspaces you belong to) or Chosen projects.

  5. 5

    Click Allow access

    Back in Claude or ChatGPT, turn on Citadex in the chat’s tools menu and ask. The app now appears under Connected apps.

Managing connected apps

The Connected apps table shows each app’s Permission, Access, Credits this month (used / limit, or Uses no credits for read-only) and Last used.

  • Edit: switch between Read only and Read + actions, change the Monthly credit limit, then Save.
  • Disconnect: the app loses access immediately.

Option 2: keys (advanced, for Cursor, Claude Code and scripts)

Open Keys (advanced) → Create key, enter a Name (which tool uses it), choose Access (All projects or Chosen projects) and click Create.

  • The full key is shown only once. Copy it, then click I have saved it.
  • You also get a Private connection URL, which contains the key. Treat it like a password.
  • Cursor: open Settings → MCP → Add new MCP server, paste the config shown on the page into mcp.json and put in your key. Other clients that support remote MCP: use the connection address with the header Authorization: Bearer YOUR_KEY.
  • Keys and private connection URLs are read-only; they cannot run actions.
  • Use one key per tool and Revoke it when you stop using that tool.
  • A key or sign-in connection created before keys were bound to an account is marked Needs re-authorization and no longer works. Create a new key (or sign in again from the assistant) and revoke or disconnect the old one.

Agencies often create a key that can see only one client’s project for that client’s reporting.

What it can read and do

Once connected, the assistant can call these tools (the tool names appear in Claude’s and ChatGPT’s activity):

GroupWhat it readsTool names
Projects & marketsYour projects, markets and engineslist_projects, list_markets
VisibilityOverview per engine, trend, sentiment, shopping cards in AI answers (your share and competitors')get_visibility_overview, get_visibility_trend, get_sentiment, get_shopping_cards
PromptsPrompt list (with each prompt’s demand source), one prompt’s evidence, one prompt’s demand evidence (by channel and market, whether verified, whether from another market) and demand heat (level 1–5 or unknown), prompt coverage (optionally for one market; by kind of question, buying stage, buying journey, brand class and four levels of demand evidence: people search it / seen in search / no search evidence / brand; plus untracked AI engine searches, the web searches engines ran before answering, which are not people's demand), each prompt’s brand class and buying-journey stage (including whether you set the class), groups of prompts that ask the same question (compared within one market, suggestions only), each prompt’s commercial opportunity grade (High / Medium / Low, with scenario, confidence, main reasons, basis and conditions)list_prompts, get_prompt_evidence, get_prompt_sources, get_prompt_coverage, get_prompt_classification, get_similar_prompts, get_prompt_opportunity
Competitors & recommendationsCompetitors and share of voice, mention to recommendation, prompt gaps (questions you don't track where AI recommends a competitor and not you)get_competitors, get_recommendation_share, get_prompt_gaps
Citation sourcesSources, gaps and opportunities, pages worth getting mentioned on, sources that cite only competitors, outreach progressget_citation_sources, get_citation_gaps, find_citation_opportunities, get_competitor_only_sources, get_outreach_status
Diagnosis & tasksOne-call diagnosis (why not recommended, why a competitor leads, ads vs organic, AI revenue), this week’s tasks, visibility drop check, brand integrity, market repair plan, fix approvals, whether what you did workedrun_diagnosis, get_suggestion_outcomes, get_opportunities, investigate_visibility_drop, check_brand_integrity, get_repair_plan, get_fix_approvals
Traffic & revenueAI revenue, ChatGPT ads, AI traffic, agent readinessget_ai_revenue, get_chatgpt_ads, get_ai_traffic, get_agent_readiness, get_industry_benchmark
Content & creditsArticles and their text, credit balancelist_articles, get_article, get_credit_balance

A Read + actions connection can also run these actions:

ActionTool nameCredits
Re-check promptsstart_scanUses credits
Add prompts to trackingadd_promptsAdding itself costs nothing, but the balance must cover the new prompts' first check, or nothing is added; adding does not check them yet
Write an article draftgenerate_articleBilled in credits; waits for review, never published automatically
Start a re-testcreate_retestFree; with "ask each prompt 3 times", every scan round during the re-test uses extra credits (shown in the quote). Business / Agency plans
Approve or reject a fixreview_fixFree; only the owner, an admin or the agency's client can approve; rejecting needs a reason
Change a market's competitorsset_market_competitorsFree
Set up the brand fact checksetup_brand_checkSaving the official facts is free; switching it on the first time adds brand-defense prompts, which use credits
Add a web page to the knowledge baseimport_kb_urlFree
Create a projectcreate_projectFree; reads the site and writes starter prompts, no check runs yet. Connections limited to some projects cannot create one
Pause or resume promptsset_prompts_activePausing is free and keeps history; resuming needs credits for the next check
Delete promptsdelete_promptsFree; to the recycle bin, restorable for 30 days, scan history removed. A prompt tracked in several markets can be deleted in one market only
Change scan frequencyset_scan_frequencyDaily / weekly / monthly; checks use credits as usual
Sort prompts into groupsorganize_prompt_groupsFree; groups every ungrouped prompt by meaning, reusing your groups first
Move prompts to a groupmove_prompts_to_groupFree; creates the group if it doesn't exist
Change prompts’ brand classset_prompt_brand_classFree; Citadex no longer changes the class once you set it; can be undone or returned to automatic; the question type stays as it is
Make a results reportcreate_reportFree; this month, last month or the last 30 days, returns a share link. Paid plans
Switch an automation on or offset_automationSwitching is free; auto-scan then checks prompts at their frequency, and the quote says about how many credits it uses per 30 days

Actions that use credits: quote first, then confirm

  1. When you ask for something that uses credits, the assistant first gets a quote: what will happen, how many credits, your balance, and what this connection may still spend this month.
  2. It shows you the quote and waits for a clear yes.
  3. Only then does it run.

Actions that use no credits work the same way: you are told what will happen and it runs only after you agree. If the data changes after the quote (say, the fix was edited), the confirmation no longer works and a new quote is needed.

If the quote is above what is left of the connection’s Monthly credit limit, the action is not run; raise the limit under Edit. Publishing articles is never allowed; that stays in Citadex. Deleted prompts go to the recycle bin and can be restored for 30 days. Viewers in a workspace cannot run actions even when connected.

The prompt library

Not sure what to ask? Open the MCP prompt library (Open prompt library on the settings page, or /mcp/prompts on the website, no sign-in needed). It has 35 ready-made prompts in five groups (Briefings & reports, Competitors, Citation sources, Content planning, Agency & client reporting), each showing which data it uses. Click Copy prompt, paste it into your connected assistant and replace the parts in square brackets. The settings page also lists a few featured prompts.

Good first questions: "How is my brand’s AI visibility this week?", "Which prompts mention competitors but not us?", "Which sources does AI cite most for my market?", "Write me a repair plan for Japan."

You can also click + in the AI Assistant's question box in Citadex → Use Citadex in ChatGPT / Claude for a guided setup.

FAQ

What does a team member see? Their access follows their role in the workspace, on the workspace owner’s projects.

Can an agency’s clients use it? Only if the agency turns on API & MCP for clients in the white label settings, and only for the projects assigned to them.

Citadex doesn’t show up in ChatGPT. Check that Developer mode is on, authentication is OAuth, and that you picked Citadex from the tools menu in a new chat. A paid ChatGPT plan is required.

How do I make a connection read-only again? In Connected apps, click Edit, choose Read only and save. It applies at once.

Was this article helpful?