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 226 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"
  • "Create a new client 'Restaurant Dupont' in the restaurant sector based in Paris"

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?"
  • "Launch a full GEO audit for client Y right now"

Prompt management

  • "Add 10 competitive prompts about online restaurant booking for client Dupont"
  • "Disable the discovery prompts for client X"
  • "Set the weight of the comparison prompts to 8 for client Y"
  • "Show me the full prompt taxonomy"

End-to-end workflow (create + prompts + audit in one sentence)

"Create a new client 'Bistro Dupont' (restaurant sector, Paris), add 10 competitive prompts about online booking, then launch a full audit immediately."

Your AI chains create_clientadd_prompts_bulklaunch_audit in a single turn — no copy-paste, no UI navigation.

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?"
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 226 public tools across 20 categories. Each tool is tagged either “Read” (read-only) or “Write” (creates, updates or deletes data), and its access level shows whether it works with an End-client key (scoped to a single client) or requires an Agent/Agency key.

Don’t miss
  • AI prompt management — create (create_custom_prompt, add_prompts_bulk), update (update_custom_prompt), toggle (toggle_client_prompt) and tune the weight (set_client_prompt_weight) of prompts straight from your AI. The full taxonomy is exposed via get_prompt_taxonomy.
  • Audits & scheduling — launch an audit (launch_audit), track progress (get_audit_progress), schedule recurring audits (create_scheduled_audit) and compare two audits (compare_audits).
  • Advanced GEO modules — SSR diagnosis (get_ssr_crawlability), entity health (get_entity_health), citation readiness (get_citation_readiness), 26-point GEO checklist (get_geo_checklist) and hallucinated URLs (get_hallucinated_urls).

Clients 26

Tool Description Mode Access
export_client_dataExporte toutes les données d'un client en JSON (GDPR data portability).ReadEnd client
get_client_brief_for_promptsRetourne le contexte client en format COMPACT pour générer des prompts pertinents.ReadPartner
get_client_competitorsListe les concurrents configurés pour un client.ReadEnd client
get_client_contactsListe les contacts d'un client.ReadEnd client
get_client_detailDétails complets d'un client (tous les champs).ReadEnd client
get_client_portal_accessObtient le lien d'accès au portail client en lecture seule.ReadPartner
get_client_portfolio_overviewDashboard résumé du portefeuille : total clients, par statut/secteur, activité récente, clients nécessitant attention.ReadPartner
get_client_preferencesPréférences du client (auto_report_default, etc.).ReadEnd client
get_client_summaryRésumé concis d'un client : infos clés, dernier audit, total audits, plans d'action actifs.ReadEnd client
get_clientsListe les clients avec filtrage et pagination. Les partners voient uniquement leurs propres clients.ReadPartner
get_clients_by_countryAgrège les clients par pays avec comptage.ReadPartner
get_clients_by_sectorAgrège les clients par secteur avec comptage. Utile pour l'analyse de portefeuille.ReadPartner
get_competitor_detailDétails complets d'un concurrent.ReadEnd client
get_contact_detailDétails d'un contact spécifique.ReadEnd client
get_geo_checklistObtient la checklist GEO complète de 26 points pour un client.ReadEnd client
get_geo_checklist_summaryRésumé de la checklist GEO : points vérifiés, score global, recommandations prioritaires.ReadEnd client
get_whitelabel_configObtient la configuration marque blanche (logo, couleurs, nom) de l'agent.ReadPartner
list_sectorsListe les secteurs d'activité disponibles, avec optionnellement les sous-secteurs.ReadPartner
search_clientsRecherche full-text parmi les clients (entreprise, description, secteur, mots-clés).ReadPartner
add_competitorAjoute un concurrent à un client pour l'analyse concurrentielle GEO.WritePartner
create_clientCrée un nouveau client. Le secteur est normalisé automatiquement vers une valeur canonique.WritePartner
create_client_portal_accessCrée un accès portail client en lecture seule avec token unique.WritePartner
remove_competitorSupprime un concurrent d'un client.WritePartner
revoke_client_portal_accessRévoque l'accès au portail client.WritePartner
update_client_detailsEnrichit les détails d'un client existant avec les champs critiques pour la génération de prompts pertinents par l'IA.WritePartner
update_whitelabel_configModifie la configuration marque blanche de l'agent.WritePartner

Audits & Scores 23

Tool Description Mode Access
compare_auditsCompare deux audits côte à côte : évolution des scores, deltas métriques, comparaison modèle par modèle.ReadEnd client
get_audit_costDétail des coûts d'un audit (crédits, requêtes, modèles utilisés).ReadEnd client
get_audit_detailDétails complets d'un audit avec tous les scores globaux.ReadEnd client
get_audit_model_performanceCompare les performances des différents modèles IA pour un audit donné.ReadEnd client
get_audit_prompt_analysisAnalyse les résultats par prompt pour un audit (meilleurs/pires scores par prompt).ReadEnd client
get_audit_resultsRésultats IA d'un audit, modèle par modèle.ReadEnd client
get_audit_scoresDétail du scoring d'un audit (étoiles, score/10, position, sentiment, mentions par modèle/prompt).ReadEnd client
get_audit_trendÉvolution des métriques clés au fil des audits pour un client.ReadEnd client
get_audit_website_analysisDonnées d'analyse du site web capturées pendant un audit.ReadEnd client
get_auditsListe les audits avec filtrage et pagination.ReadEnd client
get_best_performing_modelsClasse les modèles IA par score moyen, taux de mention et sentiment pour un client.ReadEnd client
get_client_audit_historyHistorique complet des audits d'un client : dates, scores, métriques clés, coût.ReadEnd client
get_consumption_logsLogs de consommation API détaillés (tokens, coûts, temps de réponse).ReadPartner
get_consumption_statsStatistiques de consommation agrégées : tokens, coûts, temps moyen par modèle/client/période.ReadPartner
get_geo_metricsMétriques géographiques/marché cachées pour un audit.ReadEnd client
get_hallucinated_urlsListe les URLs hallucinées détectées lors des audits, avec filtrage par client et modèle.ReadEnd client
get_hallucinated_urls_by_modelAnalyse les URLs hallucinées groupées par modèle d'IA pour un client.ReadPartner
get_mention_analysisAnalyse des mentions d'un client dans les réponses IA : types, fréquence, sentiment.ReadEnd client
get_native_vs_web_scoresCompare les scores natif vs web par modèle pour un audit donné.ReadEnd client
get_scheduled_auditsListe les audits programmés (quotidien, hebdomadaire, mensuel) avec filtrage par client et statut.ReadPartner
create_scheduled_auditCrée un audit programmé. frequency: 'daily', 'weekly', 'monthly'.WritePartner
delete_scheduled_auditSupprime un audit programmé.WritePartner
update_scheduled_auditModifie un audit programmé (fréquence, activation/désactivation).WritePartner

Audit launch 3

Tool Description Mode Access
estimate_audit_costEstime le coût en crédits d'un audit pour un client avant de le lancer. Basé sur le nombre de prompts actifs et de modèles activés.ReadPartner
get_audit_progressConsulte la progression d'un audit en cours ou récemment terminé. Retourne le statut, le pourcentage d'avancement et les compteurs.ReadPartner
launch_auditLance un audit de visibilité IA pour un client. Retourne l'audit_id et le coût estimé. Nécessite le rôle partner ou admin.WritePartner

Action plans 5

Tool Description Mode Access
get_action_libraryBibliothèque d'actions recommandées avec catégories, priorités, difficulté et impact.ReadEnd client
get_action_library_itemDétails d'une action de la bibliothèque (descriptions bilingues, priorité, impact).ReadEnd client
get_action_plan_detailDétails complets d'un plan d'action incluant findings JSON et évolution métrique.ReadEnd client
get_action_plan_progressRésumé de la progression des plans d'action : total, par statut, taux de complétion.ReadEnd client
get_action_plansListe les plans d'action d'un client avec statut et progression.ReadEnd client

PDF reports 6

Tool Description Mode Access
download_reportTélécharge un rapport PDF. Retourne le contenu en base64 pour les petits fichiers.ReadEnd client
get_pdf_configConfiguration PDF actuelle du client (template, branding, sections, destinataire).ReadPartner
get_pdf_premium_promptsListe les prompts premium PDF configurés pour un client ou globalement.ReadPartner
get_report_detailDétails complets d'une génération PDF (incluant erreur si échouée).ReadEnd client
get_report_generation_statsStatistiques de génération PDF : total, durée moyenne, taux succès/échec, crédits consommés.ReadPartner
list_reportsListe les rapports PDF générés avec statut, durée et crédits consommés.ReadEnd client

Credits 8

Tool Description Mode Access
get_credit_balanceObtient le solde actuel de crédits de l'agent. Agency-aware: retourne les crédits du pool agence si applicable.ReadPartner
get_credit_forecastPrédiction d'épuisement des crédits basée sur la consommation récente.ReadPartner
get_credit_historyHistorique des mouvements de crédits avec filtrage.ReadPartner
get_credit_packsListe les packs de crédits disponibles à l'achat.ReadPartner
get_credit_purchasesHistorique des achats de crédits (montants, méthodes, statuts).ReadPartner
get_credit_transactionsTransactions de crédits liées aux clients.ReadPartner
get_credit_usage_summaryRésumé de la consommation de crédits : total consommé, par période/audit, coût moyen, burn rate, jours restants estimés.ReadPartner
get_creditsSolde de crédits actuel de l'utilisateur. Agency-aware: retourne les crédits du pool agence si applicable.ReadPartner

Subscriptions 5

Tool Description Mode Access
get_subscriptionDétails de l'abonnement actuel (plan, crédits restants/utilisés, date renouvellement, statut).ReadPartner
get_subscription_historyHistorique des changements d'abonnement (upgrades, downgrades, annulations).ReadPartner
get_subscription_notificationsNotifications liées aux abonnements (rappels renouvellement, confirmations paiement).ReadPartner
get_subscription_plansListe tous les plans d'abonnement avec tarifs, fonctionnalités et crédits.ReadPartner
get_subscription_transactionsTransactions Stripe de paiement des abonnements.ReadPartner

Prompts 13

Tool Description Mode Access
get_client_base_promptsPrompts de base activés/désactivés pour un client avec leurs poids.ReadEnd client
get_client_prompt_configConfiguration complète des prompts d'un client : base + custom + poids.ReadEnd client
get_custom_promptsListe les prompts personnalisés d'un client.ReadPartner
get_prompt_detailDétails complets d'un prompt (système ou custom).ReadPartner
get_prompt_taxonomyRetourne la structure complète de la taxonomie prompts (4 piliers / 8 intents / 30 sous-catégories) avec descriptions localisées.ReadPartner
get_promptsListe les prompts système (bibliothèque de prompts d'audit).ReadPartner
get_user_base_promptsPrompts de base activés/désactivés au niveau utilisateur.ReadPartner
add_prompts_bulkAjoute jusqu'à 30 prompts en un seul call avec validation taxonomie + dedup.WritePartner
create_custom_promptCrée un prompt personnalisé avec validation taxonomie complète.WritePartner
delete_custom_promptSupprime un prompt d'un client. Supporte les prompts custom ET les références à un prompt de base (désactive l'héritage).WritePartner
set_client_prompt_weightChange le poids (0-10) d'un prompt pour un client. Fonctionne sur custom_prompts ET client_base_prompts. Le poids influence le scoring.WritePartner
toggle_client_promptActive/désactive un prompt pour un client (custom ou base). Identique au toggle de l'UI web.WritePartner
update_custom_promptMet à jour un prompt d'un client. Si c'est un prompt de base, il est automatiquement transformé en prompt personnalisé (comme dans l'UI web). Seuls les champs fournis (non None) sont modifiés.WritePartner

AI configuration 7

Tool Description Mode Access
compare_model_pricingCompare le pricing de tous les modèles actifs (coût input/output par 1K tokens), trié par coût.ReadPartner
get_client_ai_configConfiguration IA d'un client (modèles activés, ordre d'affichage, paramètres custom).ReadEnd client
get_client_model_statsStats par modèle pour un client : audits exécutés, score moyen, dernier audit, coût cumulé.ReadEnd client
get_model_detailDétails complets d'un modèle IA (pricing, max tokens, provider).ReadEnd client
get_model_pricingPricing actuel des modèles IA (cache temps réel).ReadPartner
get_modelsListe tous les modèles IA disponibles avec pricing et statut.ReadEnd client
get_openrouter_configConfiguration LLM d'un client (modèles activés, settings). N'expose PAS la clé API.ReadPartner

GEO modules 5

Tool Description Mode Access
get_citation_readinessModule GEO 4 — Citation Readiness Score (étude Princeton GEO KDD 2024). Évalue la citabilité du contenu : sources externes, statistiques, experts, structure paragraphes, questions H2/H3, réponses directes.ReadPartner
get_entity_healthModule GEO 2 — Entity Health Check (Wikidata + Schema.org). Retourne existence Wikidata, propriétés, balisage Schema.org Organization, liens sameAs validés.ReadPartner
get_mention_citationModule GEO 3 — Tracking Mention vs Citation. Distingue mentions simples, citations avec lien source, et recommandations explicites. Retourne le ratio M/C par modèle.ReadPartner
get_ssr_crawlabilityModule GEO 1 — Diagnostic SSR / Crawlabilité IA. Retourne le score composite, détection SSR, analyse robots.txt, test WAF par user-agent IA, présence llms.txt/llms-full.txt.ReadPartner
get_sts_detectionModule GEO 5 — STS Detection (Search Text Spoofing, expérimental). Détecte les techniques de manipulation chez les concurrents : texte caché, token stuffing, meta tags excessifs, micro-texte CSS.ReadPartner

AI tracking 8

Tool Description Mode Access
get_tracking_alertsAlertes tracking IA pour un client (bots disparus, pics de trafic, installations stale…). Triées par sévérité (critical > warning > info) puis date.ReadEnd client
get_tracking_correlationCorrélation entre les crawls IA et les citations/referrals IA pour un client. Compare les URLs crawlées, citées dans les audits, et référencées par les IA.ReadEnd client
get_tracking_pagesPages les plus crawlées et référencées par les IA. Retourne URL, nombre de crawls, nombre de referrals, bots ayant crawlé, sources de referral, et statut (high_visibility, crawled_not_cited, referral_without_crawl).ReadEnd client
get_tracking_portfolioVue portefeuille tracking : liste des clients avec tracking installé, santé de chaque installation, stats agrégées (crawls, referrals) sur la période.ReadPartner
get_tracking_referral_trendsTendances referrals IA sur le portefeuille : top sources, évolution hebdomadaire, et top clients par volume de referrals.ReadPartner
get_tracking_statsStats agrégées de tracking IA : total crawls, total referrals, bots uniques, sources uniques, tendances vs période précédente, breakdown bots/referrers, timeseries quotidien.ReadEnd client
get_tracking_statusStatut des installations tracking d'un client : plugin installé, version, domaine, santé (healthy/warning/stale/pending/no_data), compteurs d'événements.ReadEnd client
get_tracking_top_botsTop bots IA crawlant les sites du portefeuille. Retourne le nom du bot, provider, catégorie, nombre total de crawls, nombre de clients touchés.ReadPartner

Showcase pages 7

Tool Description Mode Access
get_my_referral_statsStatistiques de parrainage de l'utilisateur courant : code, total filleuls, convertis, crédits gagnés.ReadEnd client
get_platform_changelogListe les dernières nouveautés de la plateforme (changelog).ReadEnd client
get_showcase_contentContenu généré de la page vitrine d'un client dans une langue donnée.ReadPartner
get_showcase_statusStatut de la page vitrine d'un client : activé, slug, URL publique.ReadPartner
list_showcase_clientsListe tous les clients ayant une page vitrine activée.ReadPartner
regenerate_showcaseRégénère le contenu de la page vitrine par IA (article, FAQ, meta).WritePartner
toggle_showcaseActive ou désactive la page vitrine d'un client. Génère le slug si nécessaire.WritePartner

Data quality alerts 3

Tool Description Mode Access
get_audit_alertsRécupère les alertes qualité des données pour un audit. Retourne les alertes non-dismissed, triées par sévérité (error > warning > info).ReadEnd client
get_client_alertsRécupère les alertes qualité du dernier audit terminé d'un client. Retourne les alertes non-dismissed, triées par sévérité, limitées à 50.ReadEnd client
dismiss_alertDismiss (masquer) une alerte qualité des données. Marque l'alerte comme dismissed avec un timestamp.WriteEnd client

Questionnaires 4

Tool Description Mode Access
compare_questionnaire_responsesCompare les réponses entre deux audits pour un même client.ReadEnd client
get_custom_questionnairesListe les questionnaires personnalisés d'un client.ReadEnd client
get_questionnaire_completion_statusVérifie quelles sections du questionnaire sont remplies et lesquelles sont en attente.ReadEnd client
get_questionnaire_responsesRéponses au questionnaire d'un client (optionnellement pour un audit spécifique).ReadEnd client

Agency 9

Tool Description Mode Access
get_agency_agentsListe tous les agents de l'agence avec rôle, crédits et nombre de clients.ReadAgency
get_agency_clientsListe tous les clients de tous les agents de l'agence.ReadAgency
get_agency_credit_poolDétail du pool de crédits de l'agence avec allocation par agent.ReadAgency
get_agency_dashboardVue d'ensemble de l'agence : agents, clients, crédits pool, activité récente.ReadAgency
get_agency_whitelabelConfig white-label de l'agence (logo, couleurs, nom commercial, coordonnées contact, site web). Toutes les colonnes wl_* de la table agencies.ReadAgency
allocate_agency_creditsAlloue des crédits du pool à un agent spécifique.WriteAgency
invite_agency_agentInvite un nouvel agent à rejoindre l'agence par email.WriteAgency
remove_agency_agentRetire un agent de l'agence (désactive son membership).WriteAgency
transfer_agency_clientTransfère un client d'un agent à un autre au sein de l'agence.WriteAgency

Analytics & dashboards 7

Tool Description Mode Access
export_client_full_report_dataExport complet de toutes les données d'audit d'un client en JSON structuré.ReadEnd client
get_client_360Vue 360° complète d'un client en un seul appel : profil, contacts, concurrents, audits complets (latest + previous + historique), model breakdown, progress summary, website analysis, action plans enrichis, modules GEO (SSR, entity, mention, citation, STS), data alerts. Les données financières (crédits, abonnement, config PDF) ne sont visibles que pour les agents et admins.ReadEnd client
get_partner_dashboardDashboard partenaire : portefeuille clients, scores agrégés, audits, crédits consommés, top/bottom clients.ReadPartner
get_score_distributionDistribution statistique des scores d'audit : histogramme, percentiles, moyenne, médiane.ReadPartner
get_sector_benchmarksBenchmarks sectoriels IA : métriques moyennes/médianes/percentiles par secteur d'activité et par modèle IA. Utile pour comparer un client à son secteur.ReadPartner
get_visibility_leaderboardClassement des clients par score de visibilité (dernier audit). Utile pour les partenaires.ReadPartner
search_everythingRecherche globale cross-tables (clients, audits, contacts, concurrents, prompts). Résultats catégorisés.ReadPartner

Blog & glossary 5

Tool Description Mode Access
get_blog_article_detailContenu complet d'un article avec traductions, FAQs et notations.ReadEnd client
get_blog_article_faqsFAQs d'un article de blog dans une langue.ReadEnd client
get_blog_articlesListe les articles de blog avec filtrage.ReadEnd client
get_glossary_term_detailTerme du glossaire complet avec traductions et termes associés.ReadEnd client
get_glossary_termsListe les termes du glossaire avec filtrage.ReadEnd client

Users 2

Tool Description Mode Access
get_my_profileProfil de l'utilisateur connecté (sous-ensemble sûr des champs).ReadPartner
get_partner_clients_summaryRésumé des clients du partenaire connecté : dernier audit, score visibilité, plans d'action.ReadPartner

System & security 1

Tool Description Mode Access
get_user_activity_logMes propres logs d'activité. Chaque utilisateur peut consulter son historique d'actions sur la plateforme.ReadPartner

Your MCP key & access 5

Tool Description Mode Access
get_my_access_requestsListe les demandes d'accès aux outils de l'utilisateur.ReadEnd client
get_my_mcp_usageStatistiques d'utilisation MCP de l'utilisateur connecté.ReadEnd client
get_my_permissionsListe les outils autorisés sur la clé API utilisée.ReadEnd client
list_available_toolsListe les outils MCP accessibles selon votre rôle. Chaque rôle ne voit que ses outils autorisés.ReadEnd client
request_tool_accessSoumet une demande d'accès à un outil. Crée une demande en attente de validation admin.WriteEnd client

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 226 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 600 bonus credits.

Create free account