AI Features Features How it works Pricing FAQ Blog Tutorial Glossary About Us Agencies
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 140 tools to access all your data: clients, audits, scores, PDF reports, credits, prompts, and more.

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",
        "mcp-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.

Installing Gemini CLI

If Gemini CLI is not yet installed on your computer:

Terminal
npm install -g @anthropic-ai/gemini-cli

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 mcp-remote
{
  "mcpServers": {
    "ailabsaudit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-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 80 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

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

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 SEO 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 140 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 1000 bonus credits.

Create free account