MCP Guide

Connect your AI to AILabsAudit

Access your audits, clients and data directly from ChatGPT, Claude, Gemini or any other MCP-compatible AI assistant. Setup in 5 minutes.

Table of Contents

  1. What is MCP?
  2. Create your API key
  3. Connect your AI
  4. What can you do with it?
  5. All available tools
  6. Give MCP access to your clients
  7. Frequently asked questions

What is MCP?

MCP (Model Context Protocol) is an open standard that allows AI assistants (like ChatGPT, Claude or Gemini) to connect directly to external services.

In practice, this means you can talk to your AI and ask it to check your audits, list your clients, analyze your scores or export your data — all without leaving the conversation.

Example: You type in ChatGPT: "Show me the latest audit for client Dupont with scores by AI" — and ChatGPT fetches the answer directly from AILabsAudit.

The AILabsAudit MCP server exposes over 215 tools to access all your data: clients, audits, scores, PDF reports, credits, prompts, and more. New tools include get_geo_checklist, get_hallucinated_urls, get_native_vs_web_scores, toggle_showcase, get_scheduled_audits, create_client, get_blog_articles and get_glossary_terms.

Step 1 — Create your API key

Before connecting your AI, you need an MCP API key. It's like a password that allows your AI to authenticate with AILabsAudit.

1
Log in to your account on ailabsaudit.com
2
Go to API & Integrations (user menu in the top right, or directly via this link)
3
Click "New key", give it a name (e.g., "My ChatGPT") and click Create
4
Copy the key that appears (it starts with aila_).
This key will only be shown once. Keep it in a safe place.
Security: Never share your API key. If you think it has been compromised, you can revoke it and create a new one at any time.

Step 2 — Connect your AI

Choose your AI assistant below to see the adapted instructions:

Claude
ChatGPT
Gemini
Cursor / Windsurf
Other MCP client

Claude Desktop (application)

Claude supports MCP natively. Two methods available:

Recommended method: via the interface

1
Open Claude Desktop on your computer
2
Go to Settings then Connectors
3
Click "Add connector" and enter the URL:
https://mcp.ailabsaudit.com/mcp
4
Claude will open an authentication page — paste your API key (the one starting with aila_) and confirm
That's it! Claude now has access to your AILabsAudit data. Try asking: "List my clients" or "Show me my latest audit".

Alternative method: configuration file

If you prefer to configure manually, edit Claude's configuration file:

File location:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

claude_desktop_config.json
{
  "mcpServers": {
    "ailabsaudit": {
      "command": "npx",
      "args": [
        "-y",
        "tut-remote",
        "https://mcp.ailabsaudit.com/mcp"
      ]
    }
  }
}

Restart Claude Desktop. On first use, a page will open to enter your API key.

Prerequisite: The file method requires Node.js installed on your computer (for the npx command). The interface method (Connectors) requires nothing extra.

ChatGPT (OpenAI)

ChatGPT supports MCP servers via the "Apps" feature in Developer Mode.

1
Open ChatGPT (desktop app or chatgpt.com)
2
Go to Settings then Apps
3
Enable "Advanced" then "Developer Mode"
4
Click "Create app"
5
Enter the MCP server URL:
https://mcp.ailabsaudit.com/mcp
Select OAuth as the authentication method, then click Create
6
During your first conversation, ChatGPT will ask you to authorize the connection. Enter your API key (aila_...) in the form that appears and confirm.
Done! You can now ask ChatGPT: "Use AILabsAudit to list my clients" or "Show me the scores from my latest audit".
Prerequisite: A ChatGPT Plus, Team or Enterprise subscription is required. Developer Mode is a beta feature.

Google Gemini

Gemini supports MCP via its command-line tool Gemini CLI.

Good to know: The Gemini web interface (gemini.google.com) does not yet support custom MCP servers. To connect AILabsAudit, use Gemini CLI.

Gemini CLI installation

Gemini CLI is installed via npm (requires Node.js 18+):

Terminal
npm install -g @anthropic-ai/gemini-cli
Note: Unlike Claude Code, Gemini CLI does not have a dedicated standalone CLI from Google. The @anthropic-ai/gemini-cli package is a community wrapper. If you prefer, you can use the MCP server URL directly in any Gemini-compatible client (e.g. Google AI Studio) without installing this package.

Add the MCP server

Quick method (single command):

Terminal
gemini mcp add --transport http ailabsaudit https://mcp.ailabsaudit.com/mcp

File method: edit ~/.gemini/settings.json:

~/.gemini/settings.json
{
  "mcpServers": {
    "ailabsaudit": {
      "url": "https://mcp.ailabsaudit.com/mcp"
    }
  }
}

On first launch, Gemini CLI will automatically detect that the server requires authentication and guide you to enter your API key.

Cursor / Windsurf (code editors)

These intelligent code editors support MCP natively via a JSON file.

Cursor

Create or edit the file .cursor/mcp.json at the root of your project (or ~/.cursor/mcp.json for all projects):

.cursor/mcp.json
{
  "mcpServers": {
    "ailabsaudit": {
      "url": "https://mcp.ailabsaudit.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "X-Api-Key": "aila_YOUR_KEY_HERE"
      }
    }
  }
}

Windsurf

Edit the file ~/.codeium/windsurf/mcp_config.json:

mcp_config.json
{
  "mcpServers": {
    "ailabsaudit": {
      "serverUrl": "https://mcp.ailabsaudit.com/mcp",
      "headers": {
        "X-Api-Key": "aila_YOUR_KEY_HERE"
      }
    }
  }
}

Restart the editor after saving the file.

Replace aila_YOUR_KEY_HERE with the API key you created in step 1.

Any other MCP client

Any software compatible with the MCP protocol can connect to AILabsAudit. Here is the connection information:

MCP Server URL
https://mcp.ailabsaudit.com/mcp
Transport
Streamable HTTP (recommended) or SSE
Authentication
OAuth 2.1 (automatic) or header X-Api-Key: aila_YOUR_KEY

Generic JSON configuration

Most MCP clients use a similar JSON format:

Generic configuration
{
  "mcpServers": {
    "ailabsaudit": {
      "url": "https://mcp.ailabsaudit.com/mcp",
      "headers": {
        "X-Api-Key": "aila_YOUR_KEY_HERE"
      }
    }
  }
}

Via npx (universal bridge)

If your client only supports local servers, you can use the mcp-remote bridge:

Configuration with tut-remote
{
  "mcpServers": {
    "ailabsaudit": {
      "command": "npx",
      "args": [
        "-y",
        "tut-remote",
        "https://mcp.ailabsaudit.com/mcp"
      ]
    }
  }
}
The mcp-remote bridge requires Node.js installed on your machine. It automatically handles OAuth authentication by opening your browser.

What can you do with it?

Once connected, you can ask your AI to do everything you normally do on AILabsAudit — in natural language. Here are some examples:

Client management

  • "List all my clients"
  • "Show me the details of client Dupont"
  • "Which of my clients are in the restaurant industry?"
  • "Give me a complete 360 view of client X"

Audits and scores

  • "Show me the results of client Y's latest audit"
  • "Compare scores between ChatGPT and Claude for this client"
  • "What's the visibility trend for my client over the last 3 months?"
  • "Which AI models give the best scores for my clients?"

Reports and export

  • "Export all audit data for client Z"
  • "Show me recently generated PDF reports"
  • "What's the average cost per audit?"

Credits and subscription

  • "How many credits do I have left?"
  • "Show me my consumption history"
  • "What credit packs are available?"

Administration (admins only)

  • "Show me the admin dashboard"
  • "Who are the most active users?"
  • "Show me today's activity logs"
  • "What's the platform health status?"
Tip: You don't need to know the exact tool names. Just talk naturally to your AI and it will automatically find the right tool to use.

All available tools

The AILabsAudit MCP server exposes over 215 tools for partners and their end clients. Tools are organized by category. Each tool is marked with the access level.

End client = accessible with a client-scoped key (scoped to a single client's data, read-only). Partner = only accessible with a partner key (your account, all clients, credits, subscription, etc.).

Clients

ToolDescriptionAccess
get_client_detailView client detailsEnd client
get_client_summaryQuick summary of a clientEnd client
get_client_contactsList contacts for a clientEnd client
get_contact_detailView a contact's detailsEnd client
get_client_competitorsList a client's competitorsEnd client
get_competitor_detailView competitor detailsEnd client
get_client_preferencesView client preferencesEnd client
export_client_dataExport all client dataEnd client
get_clientsList all your clientsPartner
search_clientsSearch clients by keywordPartner
get_clients_by_sectorFilter clients by sectorPartner
get_clients_by_countryFilter clients by countryPartner
get_client_portfolio_overviewOverview of your entire portfolioPartner

Audits & Scores

ToolDescriptionAccess
get_auditsList audits for the clientEnd client
get_audit_detailView audit detailsEnd client
get_audit_resultsGet audit results per modelEnd client
get_audit_scoresGet visibility scoresEnd client
get_audit_costView audit cost breakdownEnd client
compare_auditsCompare two auditsEnd client
get_audit_trendView score trends over timeEnd client
get_audit_model_performanceCompare model performanceEnd client
get_audit_prompt_analysisAnalyze prompt effectivenessEnd client
get_geo_metricsGeographic visibility metricsEnd client
get_client_audit_historyFull audit history for the clientEnd client
get_best_performing_modelsBest performing AI modelsEnd client
get_mention_analysisAnalyze brand mentionsEnd client
get_audit_website_analysisWebsite analysis from auditEnd client
get_consumption_logsView consumption logsPartner
get_consumption_statsAggregated consumption statsPartner

Audit Actions

ToolDescriptionAccess
launch_auditLaunch a visibility audit for a clientPartner
get_audit_progressCheck the progress of a running auditPartner
estimate_audit_costEstimate the credit cost before launching an auditPartner

Reports & PDFs

ToolDescriptionAccess
list_reportsList generated reportsEnd client
get_report_detailView report detailsEnd client
download_reportDownload a reportEnd client
get_pdf_configView PDF configurationPartner
get_pdf_premium_promptsView premium PDF promptsPartner
get_report_generation_statsReport generation statisticsPartner

Action Plans

ToolDescriptionAccess
get_action_plansList action plansEnd client
get_action_plan_detailView action plan detailsEnd client
get_action_plan_progressTrack action plan progressEnd client
get_action_libraryBrowse action libraryEnd client
get_action_library_itemView a specific actionEnd client

Questionnaires

ToolDescriptionAccess
get_questionnaire_responsesView questionnaire responsesEnd client
get_custom_questionnairesView custom questionnairesEnd client
get_questionnaire_completion_statusCheck completion statusEnd client
compare_questionnaire_responsesCompare responsesEnd client

Credits, Subscription & Account

ToolDescriptionAccess
get_creditsView your credit balancePartner
get_credit_historyCredit historyPartner
get_credit_transactionsList credit transactionsPartner
get_credit_purchasesView credit purchasesPartner
get_credit_packsAvailable credit packsPartner
get_credit_usage_summaryCredit usage summaryPartner
get_credit_forecastCredit consumption forecastPartner
get_subscriptionView current subscriptionPartner
get_subscription_plansList available plansPartner
get_subscription_historySubscription historyPartner
get_subscription_transactionsSubscription transactionsPartner
get_subscription_notificationsSubscription notificationsPartner
get_my_profileView your profilePartner
get_user_activity_logView your activity logPartner

Prompts & AI Configuration

ToolDescriptionAccess
get_client_ai_configView client AI configurationEnd client
get_client_model_statsModel usage statistics for a clientEnd client
get_client_base_promptsView client base promptsEnd client
get_client_prompt_configView prompt configurationEnd client
get_modelsList available AI modelsEnd client
get_model_detailView model detailsEnd client
get_custom_promptsView your custom promptsPartner
get_user_base_promptsView your base promptsPartner
get_openrouter_configView OpenRouter configurationPartner
get_promptsList all system promptsPartner
get_prompt_detailView prompt detailsPartner
get_model_pricingView model pricingPartner
compare_model_pricingCompare model pricingPartner

Analytics & Dashboard

ToolDescriptionAccess
get_client_360Complete 360 client view (client data only — credits/subscription excluded for client keys)End client
export_client_full_report_dataExport full report data (audits, scores, action plans)End client
get_partner_dashboardPartner dashboardPartner
get_partner_clients_summarySummary of all your clientsPartner
get_visibility_leaderboardClient visibility rankingPartner
search_everythingSearch across all dataPartner
get_score_distributionScore distribution analysisPartner

MCP Self-management

ToolDescriptionAccess
list_available_toolsList all tools you can useEnd client
get_my_permissionsView your permissionsEnd client
request_tool_accessRequest access to a toolEnd client
get_my_access_requestsView your access requestsEnd client
get_my_mcp_usageView your MCP usage statsEnd client

AI Tracking

ToolDescriptionAccess
get_tracking_statsAggregated AI tracking stats: crawls, referrals, trends, timeseriesEnd client
get_tracking_pagesTop pages crawled and referenced by AI botsEnd client
get_tracking_alertsTracking alerts: missing bots, traffic spikes, stale installsEnd client
get_tracking_statusTracking installation status and healthEnd client
get_tracking_correlationCorrelation between AI crawls and citations/referralsEnd client
get_tracking_top_botsTop AI bots crawling your portfolio sitesEnd client
get_tracking_referral_trendsAI referral trends: top sources, weekly evolutionEnd client
get_tracking_bot_signaturesBrowse known AI bot signatures catalogEnd client
get_tracking_ai_referrersBrowse known AI referrer sources catalogEnd client
get_tracking_platform_overviewPlatform-wide tracking overview (admin)Partner
get_tracking_portfolioPortfolio tracking view: all clients with install health and statsPartner

GEO Modules

ToolDescriptionAccess
get_ssr_crawlabilityGEO Module 1 — SSR / AI Crawlability diagnosticEnd client
get_entity_healthGEO Module 2 — Entity Health Check (Wikidata + Schema.org)End client
get_mention_citationGEO Module 3 — Mention vs Citation tracking per modelEnd client
get_citation_readinessGEO Module 4 — Citation Readiness Score (Princeton GEO KDD 2024)End client
get_sts_detectionGEO Module 5 — STS Detection (Search Text Spoofing, experimental)End client

Agency Management

ToolDescriptionAccess
get_agency_dashboardAgency overview: agents, clients, credit pool, recent activityPartner
get_agency_agentsList all agency agents with roles and creditsPartner
invite_agency_agentInvite a new agent to the agency by emailPartner
remove_agency_agentRemove an agent from the agencyPartner
get_agency_clientsList all clients across all agency agentsPartner
transfer_agency_clientTransfer a client from one agent to anotherPartner
get_agency_credit_poolAgency credit pool details and per-agent allocationPartner
allocate_agency_creditsAllocate credits from the pool to a specific agentPartner

Showcase & Branding

ToolDescriptionAccess
get_showcase_statusShowcase page status: enabled, slug, public URLEnd client
get_showcase_contentGenerated content of a client showcase pageEnd client
toggle_showcaseEnable or disable a client's showcase pagePartner
regenerate_showcaseRegenerate showcase content via AIPartner
list_showcase_clientsList all clients with showcase enabled (admin)Partner
get_platform_changelogLatest platform changelog entriesEnd client
get_my_referral_statsYour referral stats: code, referrals, credits earnedEnd client

Content

ToolDescriptionAccess
get_blog_articlesList blog articles with filteringEnd client
get_blog_article_detailFull article content with translations and FAQsEnd client
get_blog_article_faqsFAQs for a blog article in a given languageEnd client
get_glossary_termsList glossary terms with filteringEnd client
get_glossary_term_detailFull glossary term with translationsEnd client
get_article_ratingsArticle rating statistics (admin)Partner
get_blog_statsBlog analytics: articles by category and language (admin)Partner
get_content_overviewContent overview: articles, glossary, recent publications (admin)Partner

Data Quality Alerts

ToolDescriptionAccess
get_audit_alertsData quality alerts for an audit (sorted by severity)End client
get_client_alertsData quality alerts for a client's latest auditEnd client
dismiss_alertDismiss (hide) a data quality alertPartner

Scheduled Audits

ToolDescriptionAccess
get_scheduled_auditsList scheduled audits (daily, weekly, monthly)Partner
create_scheduled_auditCreate a scheduled audit for a clientPartner
update_scheduled_auditModify a scheduled audit (frequency, activation)Partner
delete_scheduled_auditDelete a scheduled auditPartner
Security: Tools marked Partner access your account-level data (credits, subscription, profile) — they are never exposed to end clients. Client-scoped keys are strictly enforced: a key created for client A can only access data for client A — it cannot query other clients, even if they belong to the same partner account.

Give MCP access to your clients

As a partner with an Agence+ plan, you can create scoped client keys that give your end clients direct access to their own data only via their favorite AI assistant. This is perfect for agencies who want to empower their clients with self-service AI-powered analytics.

How it works: A client-scoped key is linked to a single client. The end user can only see data for that specific client — audits, scores, action plans, reports, etc. They cannot see your other clients or any partner-level data.

Why give MCP access to your clients?

Giving your clients their own MCP key is much more than a technical feature — it's a strategic lever that transforms your audit service and strengthens your client relationships. Here's why it matters:

1. Increase the perceived value of your audits

When you deliver an audit report, the value is often perceived as a one-time deliverable. By giving your client an MCP key, you turn that static report into a living, interactive experience. Your client can ask their AI assistant questions like:

  • "What's my current visibility score and how has it evolved?"
  • "Which AI model mentions me the most?"
  • "Show me the prompts where my competitors rank higher than me"
  • "What actions should I prioritize to improve?"

This makes your audit a permanent resource, not just a PDF they read once and file away. The client keeps engaging with the data, which reinforces the value of your work.

2. Boost client retention and recurring revenue

Once your client is actively using MCP to check their scores, compare audits and track their progress, they become engaged in the process. An engaged client is far more likely to:

  • Order follow-up audits — They can see their evolution and want to track improvements
  • Stay subscribed longer — The data becomes part of their routine monitoring
  • Recommend your service — They can demonstrate the value to their own colleagues

3. Reduce your support workload

Without MCP access, every time your client wants a data point, they have to email you or schedule a call. "What was my score on Perplexity last month?" "Can you send me the comparison between my last two audits?"

With MCP, your client gets instant, self-service answers 24/7. They just ask their AI assistant. This frees up your time for higher-value work like strategy and new client acquisition.

4. Build trust through transparency

Giving your client direct access to their raw audit data shows confidence in your work. There's no "black box" — they can explore results, check individual model responses, and verify scores themselves. This transparency builds trust and positions you as a credible expert.

5. Differentiate your service from competitors

Most agencies deliver a PDF and move on. You deliver a PDF plus a live AI-powered interface where the client can explore their data anytime. This is a premium differentiator that justifies higher pricing and sets you apart from basic audit providers.

Real-world example: Imagine your client is in a meeting with their marketing team. Instead of searching for your last email with the PDF attached, they open Claude or ChatGPT and ask: "Show me our AI visibility evolution over the last 3 months with scores by model." In seconds, they have the answer — and they remember who gave them that power: you.

Step 1 — Create a client-scoped key

1

Go to API & Integrations and click "New key".

2

In Access type, select "End client (single client, read only)".

3

Select the client you want to give access to from the dropdown.

4

Click "Create key". The key will be generated and can be viewed again later (unlike partner keys, client keys are stored and can be revealed anytime via the button).

Step 2 — Send the configuration to your client

Share the following information with your client so they can configure their AI assistant:

Information to share:

  • Server URL: https://mcp.ailabsaudit.com/mcp
  • API key: the key you created (starts with aila_)
  • Transport: streamable-http

Here is a ready-to-send message template you can copy and send to your client:

Hello,

You now have access to your AI visibility data directly from your AI assistant (Claude, ChatGPT, Gemini...).

Here's how to set it up:

1. Open your AI tool settings (e.g. Claude Desktop > Settings > MCP)
2. Add a new MCP server with these details:
   - Server URL: https://mcp.ailabsaudit.com/mcp
   - API Key: YOUR_KEY_HERE
   - Transport: streamable-http

3. Once connected, you can ask things like:
   - "Show me my latest audit results"
   - "What are my visibility scores on ChatGPT and Claude?"
   - "Show me my action plan"
   - "Compare my last two audits"

Your key gives you read-only access to your own data.
For any questions, feel free to reach out!

Step 3 — What your client can do

With a client-scoped key, your end client has access to 47 tools including:

  • Audits: view results, scores, trends, model comparisons
  • Action plans: track progress, browse recommendations
  • Reports: list and download PDF reports
  • Credits: check balance, view history
  • Profile: view their own profile and activity
Important: Client keys are read-only and scoped to a single client. They cannot list other clients, access partner-level analytics, or perform any administrative actions.

Managing client keys

  • View key: Click the button next to the key to reveal it anytime
  • Regenerate: Click to revoke the old key and create a new one
  • Revoke: Click to permanently deactivate the key — your client will lose access immediately
Tip: You can create multiple keys for the same client (e.g. one for their marketing team and one for their GEO team). Each key works independently.

Frequently asked questions

Is my data secure?

Yes. Your API key gives access only to your own data. A standard user can only see their clients and audits. A partner sees those in their portfolio. Only an admin has access to everything. All communications are encrypted via HTTPS.

Does it cost credits?

No. MCP access is included in your subscription. Only actions that normally consume credits (running an audit, generating a PDF) will also consume them via MCP.

Does it work on mobile?

It depends on the app. Claude on iOS/Android can use already configured MCP servers. ChatGPT on mobile does not yet support MCP Apps. For Gemini, you need to use the CLI (computer only).

Can I revoke my key at any time?

Yes. Go to API & Integrations, and click the delete button next to the relevant key. Access will be cut off immediately.

My AI can't find the AILabsAudit tools

Check that:

  • Your API key is valid and has not been revoked
  • The server URL is correct: https://mcp.ailabsaudit.com/mcp
  • Your AI client has been restarted after configuration
  • You explicitly mention "AILabsAudit" in your message so the AI knows which tool to use

How many tools are available?

The MCP server exposes over 215 tools across categories: clients, audits, scores, reports, credits, subscriptions, prompts, AI configuration, newsletter, blog, glossary, users, partners, system and analytics.

Ready to connect your AI?

Create your API key in 30 seconds and start using AILabsAudit from your favorite AI assistant.

Create my API key

Ready to audit your AI visibility?

Create your free account and receive 500 bonus credits.

Create free account