Skip to content

Kelki MCP connector

The Kelki MCP connector lets your AI assistant prepare a callback request with you from a local trade pro, anywhere in France. Server URL: https://kelki.ai/mcp, no account or API key needed. You confirm your request with one click in the email you receive, and it is sent to local professionals in your area.

100% free for you · No obligation

MCP in two sentences

The Model Context Protocol (MCP) is an open standard that allows an AI assistant (ChatGPT, Claude, Le Chat, Cursor, VS Code…) to use tools and data provided by an external service. The assistant discovers the server's tools, then calls them during the conversation using JSON‑RPC 2.0 over HTTPS.

What the Kelki connector does

You tell your assistant: “Find me a plumber in Créteil for a leak under the sink”. With the connector, the assistant:

  • finds the right trade among the 89 available trades (trouver_service);
  • suggests the trade's services and timeframes, using the exact same options as the “Call me back” form on kelki.ai (lister_prestations);
  • checks your town and its French postcode (verifier_lieu);
  • shows you the summary along with the consent agreement, then records the request once you say yes (demander_rappel).

Vous recevez alors un e‑mail « Confirmer ma demande »: un clic, et votre demande part vers les professionnels du métier de votre secteur : un seul pro vous rappelle. Not the right pro for you? Ask for another pro in one click. Le service est gratuit pour vous.

Who it is for
Who it is for:for people who use an AI assistant every day, and for platforms, developers, and AI agents looking to offer “get a callback from a local pro near you”.
For the general overview, seeKelki in your AI assistant
for on‑site chat and A2A,the Kelki Agent

URL, protocol and limits

ItemValue
URLhttps://kelki.ai/mcp
TransportStreamable HTTP: POST /mcp, one JSON‑RPC 2.0 message per request, application/json response; stateless server (GET and DELETE return 405 to MCP clients; opening the URL in a browser lands on this page)
Authenticationopen access: no account, no API key, no OAuth required
Protocol versions2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26
Version 2026‑07‑28stateless: each request carries _meta io.modelcontextprotocol/protocolVersion and io.modelcontextprotocol/clientCapabilities; headers MCP-Protocol-Version, Mcp-Method, and Mcp-Name; server/discover; service and timeframe selection in an assistant form (elicitation, result input_required) if the client declares elicitation
2025 versionsinitialize (requested version if supported, otherwise 2025‑11‑25); signed Mcp-Session-Id issued upon initialize; JSON‑RPC batches accepted in 2025‑03‑26
Serverkelki · “Kelki” · version 1.0.0; capabilities tools, resources, prompts, completions, extensions
Rate limits240 requests per minute per IP address; 60 requests per IP address over 10 minutes; 3 requests per phone number or email over 24 hours; 300 pending confirmation requests per hour across all clients; request body size 64 KB max
Confirmationeach request must be confirmed by the person: “Confirm my request” email, link valid for 48 hours; the request is sent to pros only after this click
Trades89 trades in the connector (emergency repairs, home & building, beauty & personal care, automotive, consulting, events); the 11 healthcare professions (Ambulance driver, Hearing aid specialist, Dietitian, Registered nurse, Physiotherapist, Naturopath, Home optician, Osteopath, Podiatrist, Psychologist, Sophrologist) are available on the kelki.ai website via the “Call me back” form
Web originsserver‑to‑server calls accepted; from a browser (CORS): chat.mistral.ai, chat.openai.com, chatgpt.com, claude.ai, claude.com, console.mistral.ai, gemini.google.com, kelki.ai, www.kelki.ai

The 4 tools

Exact definitions returned by tools/list, examples run against live lists. Requests in version 2025‑11‑25 (header MCP-Protocol-Version: 2025‑11‑25). Each result includes human‑readable text, the same content in JSON, and structuredContent matching the outputSchema.

trouver_service— Find the right trade
read‑only: yes (readOnlyHint = true)destructive: no (destructiveHint = false)idempotent: yes (idempotentHint = true)open world: no (openWorldHint = false)

Searches among Kelki's 89 trades for those matching a need described in plain everyday words (“leak under the sink”, “home haircut”, “wasps nest”). Returns for each likely trade its identifier, its name, the closed list of its services (from the kelki.ai “Call me back” form, plus “Other need”), and services matching the query keywords. Read‑only.

ParameterTypeRequiredDescription and constraints
needstringyesThe need described in the user's own words, e.g. “leak under the sink”, “plombier”.2 to 200 characters

Result (structuredContent): ok (boolean), besoin (string), metiers (array of objects), erreur (string), champ (string), choix (array of strings).

Example call:
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "trouver_service",
    "arguments": {
      "besoin": "fuite sous l’évier"
    }
  }
}
Response (excerpt: first element of the list):
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Métiers correspondant à « fuite sous l’évier » (le plus probable d'abord) :\n1. Plombier (metier = plombier) — correspond à : Recherche et réparation de fuites\n   Prestations : Recherche et réparation de fuites ; Débouchage de canalisations ; Installation et remplacement de robinetterie ; Installation et réparation de chauffe-eau ; Entretien et réparation de chaudière ; Rénovation de salle de bain ; Intervention après dégât des eaux ; Installation et raccordement électroménager ; Autre besoin\n…"
      },
      {
        "type": "text",
        "text": "{\"ok\": true, \"besoin\": \"fuite sous l’évier\", \"metiers\": [{\"metier\": \"plombier\", \"nom\": \"Plombier\", \"activite\": \"plomberie\", \"famille\": \"Réparations et urgences\", \"prestations\": [\"Recherche et réparation de fuites\", \"Débouchage de canalisations\", \"Installation et remplacement de robinetterie\", \"Installation et réparation de chauffe-eau\", \"Entretien et réparation de chaudière\", \"Rénovation de salle de bain\", \"Intervention après dégât des eaux\", \"Installation et raccordement électroménager\", \"Autre besoin\"], \"prestations_correspondantes\": [\"Recherche et réparation de fuites\"], \"page\": \"https://kelki.ai/plombier/\"}]}"
      }
    ],
    "structuredContent": {
      "ok": true,
      "besoin": "fuite sous l’évier",
      "metiers": [
        {
          "metier": "plombier",
          "nom": "Plombier",
          "activite": "plomberie",
          "famille": "Réparations et urgences",
          "prestations": [
            "Recherche et réparation de fuites",
            "Débouchage de canalisations",
            "Installation et remplacement de robinetterie",
            "Installation et réparation de chauffe-eau",
            "Entretien et réparation de chaudière",
            "Rénovation de salle de bain",
            "Intervention après dégât des eaux",
            "Installation et raccordement électroménager",
            "Autre besoin"
          ],
          "prestations_correspondantes": [
            "Recherche et réparation de fuites"
          ],
          "page": "https://kelki.ai/plombier/"
        }
      ]
    },
    "isError": false
  }
}
lister_prestations— Services and timeframes for a trade
read‑only: yes (readOnlyHint = true)destructive: no (destructiveHint = false)idempotent: yes (idempotentHint = true)open world: no (openWorldHint = false)

Returns the closed lists from the kelki.ai “Call me back” form for a trade: its services (plus “Other need”, to be described in a few words), the available timeframes (label and detail, tailored to the trade), and the exact consent text accepted before submitting. Read‑only.

ParameterTypeRequiredDescription and constraints
metierstringyesTrade identifier, e.g. plombier (see trouver_service).closed list of 89 values, e.g. chauffagiste, depannage-informatique, deratisation, electricien… (resource kelki://metiers)

Result (structuredContent): ok (boolean), metier (string), nom (string), activite (string), famille (string), prestations (array of strings), delais (array of objects), texte_accord (string), page (string), erreur (string), champ (string), choix (array of strings).

Example call:
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "lister_prestations",
    "arguments": {
      "metier": "plombier"
    }
  }
}
Response:
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Plombier — prestations (une au choix) :\n- Recherche et réparation de fuites\n- Débouchage de canalisations\n…"
      },
      {
        "type": "text",
        "text": "{\"ok\": true, \"texte_accord\": \"J'accepte que ma demande et mes coordonnées soient transmises à un ou plusieurs professionnels du métier de mon secteur, qui pourront me rappeler à ce sujet.\", \"metier\": \"plombier\", \"nom\": \"Plombier\", \"activite\": \"plomberie\", \"famille\": \"Réparations et urgences\", \"prestations\": [\"Recherche et réparation de fuites\", \"Débouchage de canalisations\", \"Installation et remplacement de robinetterie\", \"Installation et réparation de chauffe-eau\", \"Entretien et réparation de chaudière\", \"Rénovation de salle de bain\", \"Intervention après dégât des eaux\", \"Installation et raccordement électroménager\", \"Autre besoin\"], \"delais\": [{\"libelle\": \"C’est urgent\", \"precision\": \"Dès que possible\"}, {\"libelle\": \"Cette semaine\", \"precision\": \"Dans les prochains jours\"}, {\"libelle\": \"Ce mois-ci\", \"precision\": \"Sans urgence\"}, {\"libelle\": \"Je me renseigne\", \"precision\": \"Pour un projet à venir\"}], \"page\": \"https://kelki.ai/plombier/\"}"
      }
    ],
    "structuredContent": {
      "ok": true,
      "texte_accord": "J'accepte que ma demande et mes coordonnées soient transmises à un ou plusieurs professionnels du métier de mon secteur, qui pourront me rappeler à ce sujet.",
      "metier": "plombier",
      "nom": "Plombier",
      "activite": "plomberie",
      "famille": "Réparations et urgences",
      "prestations": [
        "Recherche et réparation de fuites",
        "Débouchage de canalisations",
        "Installation et remplacement de robinetterie",
        "Installation et réparation de chauffe-eau",
        "Entretien et réparation de chaudière",
        "Rénovation de salle de bain",
        "Intervention après dégât des eaux",
        "Installation et raccordement électroménager",
        "Autre besoin"
      ],
      "delais": [
        {
          "libelle": "C’est urgent",
          "precision": "Dès que possible"
        },
        {
          "libelle": "Cette semaine",
          "precision": "Dans les prochains jours"
        },
        {
          "libelle": "Ce mois-ci",
          "precision": "Sans urgence"
        },
        {
          "libelle": "Je me renseigne",
          "precision": "Pour un projet à venir"
        }
      ],
      "page": "https://kelki.ai/plombier/"
    },
    "isError": false
  }
}
verifier_lieu— Verify a town
read‑only: yes (readOnlyHint = true)destructive: no (destructiveHint = false)idempotent: yes (idempotentHint = true)open world: no (openWorldHint = false)

Verifies a town or postcode in France (“Créteil”, “94000”, “Paris 15”) and returns matching real towns: name, postcode, département, sorted by population (up to 10). A single town can have multiple postcodes, e.g.

ParameterTypeRequiredDescription and constraints
ville_ou_code_postalstringyesTown, postcode or both, e.g. “Créteil 94000”.2 to 80 characters

Result (structuredContent): ok (boolean), recherche (string), villes (array of objects), erreur (string), champ (string), choix (array of strings).

Example call:
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "verifier_lieu",
    "arguments": {
      "ville_ou_code_postal": "Créteil"
    }
  }
}
Response (excerpt: first element of the list):
{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "1 ville(s) pour « Créteil » :\n- Créteil (94000), Val-de-Marne (94) : ville = Créteil, code_postal = 94000"
      },
      {
        "type": "text",
        "text": "{\"ok\": true, \"recherche\": \"Créteil\", \"villes\": [{\"ville\": \"Créteil\", \"code_postal\": \"94000\", \"libelle\": \"Créteil (94000)\", \"departement\": \"Val-de-Marne\", \"departement_code\": \"94\"}]}"
      }
    ],
    "structuredContent": {
      "ok": true,
      "recherche": "Créteil",
      "villes": [
        {
          "ville": "Créteil",
          "code_postal": "94000",
          "libelle": "Créteil (94000)",
          "departement": "Val-de-Marne",
          "departement_code": "94"
        }
      ]
    },
    "isError": false
  }
}
demander_rappel— Send a callback request
read‑only: no (readOnlyHint = false)destructive: no (destructiveHint = false)idempotent: no (idempotentHint = false)open world: yes (openWorldHint = true)

Creates a callback request on Kelki and sends the person a confirmation email. The request is forwarded to one or more local trade pros in their area only after they click “Confirm my request” in that email (link valid for 48 hrs; without clicking, the request and contact details are permanently deleted). metier, prestation, and delai take values from the lister_prestations lists; ville and code_postal from verifier_lieu; nom, telephone, and email are provided by the user. accord must be true once the person has accepted, following a summary of their request, this text: “I agree to my request and contact details being sent to one or more trade pros in my area, who may call me back regarding this.”

ParameterTypeRequiredDescription and constraints
metierstringyesIdentifier of the chosen trade, e.g. plombier.closed list of 89 values, e.g. chauffagiste, depannage-informatique, deratisation, electricien… (resource kelki://metiers)
prestationstringyesA service from the lister_prestations list for this trade, or “Other need”.120 characters max
besoin_librestringnoA brief description of the need in a few words, mandatory if “Other need” is selected.160 characters max
delaistringyesA timeframe from the lister_prestations list for this trade.closed list: “As soon as possible”; “This week”; “In the coming weeks”; “Just browsing”; “For a specific date”; “In the coming months”; “It’s urgent”; “This month”
citystringyesTown returned by verifier_lieu.120 characters max
code_postalstringyesPostcode returned by verifier_lieu (5 digits).pattern ^[0-9]{5}$
nomstringyesFull name of the person to be called back.2 to 80 characters
telephonestringyesFrench phone number, e.g. 06 12 34 56 78.30 characters max
emailstringyesEmail address of the person: receives the confirmation link.email format · 254 characters max
messagestringnoOptional note from the person (availability, extra details).2000 characters max
accordbooleanyestrue: the user accepted the consent text returned by lister_prestations.

Result (structuredContent): ok (boolean), statut (string), email_masque (string), expire_le (string), message (string), demande (object), erreur (string), champ (string), choix (array of strings).

Example call (sample data; live calls will create the request and send the confirmation email):
{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "demander_rappel",
    "arguments": {
      "metier": "plombier",
      "prestation": "Recherche et réparation de fuites",
      "delai": "C’est urgent",
      "ville": "Créteil",
      "code_postal": "94000",
      "nom": "Camille Exemple",
      "telephone": "06 00 00 00 00",
      "email": "camille@exemple.fr",
      "message": "Joignable après 18 h",
      "accord": true
    }
  }
}
Response:
{
  "jsonrpc": "2.0",
  "id": 5,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Demande enregistrée. Dernière étape : un e-mail vient d'être envoyé à c•••@exemple.fr. La personne clique sur « Confirmer ma demande » dans les 48 heures pour la transmettre à un ou plusieurs professionnels du métier de son secteur, qui la rappelleront. Sans ce clic, la demande s'efface."
      },
      {
        "type": "text",
        "text": "{\"ok\": true, \"statut\": \"a_confirmer\", \"email_masque\": \"c•••@exemple.fr\", \"expire_le\": \"2026-11-02T09:30:00Z\", \"message\": \"Demande enregistrée. Dernière étape : un e-mail vient d'être envoyé à c•••@exemple.fr. La personne clique sur « Confirmer ma demande » dans les 48 heures pour la transmettre à un ou plusieurs professionnels du métier de son secteur, qui la rappelleront. Sans ce clic, la demande s'efface.\", \"demande\": {\"metier\": \"Plombier\", \"prestation\": \"Recherche et réparation de fuites\", \"delai\": \"C’est urgent\", \"lieu\": \"Créteil (94000)\"}}"
      }
    ],
    "structuredContent": {
      "ok": true,
      "statut": "a_confirmer",
      "email_masque": "c•••@exemple.fr",
      "expire_le": "2026-11-02T09:30:00Z",
      "message": "Demande enregistrée. Dernière étape : un e-mail vient d'être envoyé à c•••@exemple.fr. La personne clique sur « Confirmer ma demande » dans les 48 heures pour la transmettre à un ou plusieurs professionnels du métier de son secteur, qui la rappelleront. Sans ce clic, la demande s'efface.",
      "demande": {
        "metier": "Plombier",
        "prestation": "Recherche et réparation de fuites",
        "delai": "C’est urgent",
        "lieu": "Créteil (94000)"
      }
    },
    "isError": false
  }
}

An out‑of‑list value returns an explicit error (isError: true) pointing out the invalid parameter so the assistant can correct it:

{
  "jsonrpc": "2.0",
  "id": 9,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Métier inconnu : « plombie ». Utilisez un identifiant renvoyé par trouver_service."
      }
    ],
    "structuredContent": {
      "ok": false,
      "erreur": "Métier inconnu : « plombie ». Utilisez un identifiant renvoyé par trouver_service.",
      "champ": "metier"
    },
    "isError": true
  }
}

Consent text accepted by the user before demander_rappel: “I agree to my request and contact details being sent to one or more trade pros in my area, who may call me back regarding this.”

Resources, prompt and UI picker

  • ui://kelki/demande-v1.html: Kelki request form (text/html;profile=mcp-app): Interactive step‑by‑step picker: service, timeframe, town, contact details, consent.
  • kelki://metiers: Kelki trade list (application/json): Identifier, name, activity, and category for each trade.
  • kelki://accord: Consent text & email confirmation flow (text/plain): Terms accepted by the user and confirmation walkthrough.
  • kelki://metier/{metier}: Services and timeframes for a trade (text/markdown): Services, timeframes, and FAQs published for a specific trade. One resource per trade (89).
  • Prompt trouver_un_professionnel: “Get a callback from a local pro near me”: Prepare a Kelki callback request: trade, service, timeframe, town, then confirmation. Arguments: besoin (required, What you need, e.g. “leak under the sink”); ville (optional, Town or French postcode).
  • Completions: (completion/complete): towns for the prompt's ville argument, trade names for besoin, trade identifiers for the resource parameter metier.
  • Interactive UI picker (MCP Apps): extension io.modelcontextprotocol/ui, resource ui://kelki/demande-v1.html (text/html;profile=mcp-app), linked to trouver_service and lister_prestations via _meta.ui.resourceUri. In compatible assistants, the user selects the service, timeframe, and town with interactive buttons, enters their details, ticks the consent box, and submits; the component invokes verifier_lieu and demander_rappel via the assistant without direct network calls. Other assistants remain in text mode.
Kelki (kelki.ai) transmet une demande de rappel à un ou plusieurs professionnels du métier choisi, dans la ville de la personne : dépannage, travaux, beauté, conseil, auto, événementiel…, partout en France. Kelki ne publie ni classement ni avis de professionnels : la demande part vers les professionnels du secteur, qui rappellent la personne.
Déroulé d'une demande, avec les mêmes listes de choix que le formulaire « Rappelez-moi » du site :
1. trouver_service : métiers correspondant au besoin décrit ; la personne choisit le sien.
2. lister_prestations : prestations du métier (plus « Autre besoin », à décrire en quelques mots), délais possibles et texte d'accord. La personne choisit une prestation et un délai dans ces listes ; elle peut ajouter un commentaire libre.
3. verifier_lieu : villes et codes postaux existants ; si plusieurs correspondent, la personne choisit.
4. Nom, téléphone (numéro français) et e-mail sont ceux que la personne donne elle-même.
5. Avant demander_rappel : récapitulatif de la demande et texte d'accord exact présentés à la personne ; accord = true après son oui explicite.
6. demander_rappel enregistre la demande et envoie un e-mail à la personne : la demande est transmise aux professionnels après son clic sur « Confirmer ma demande » (lien valable 48 h ; sans clic, elle est effacée).
Le service est gratuit pour la personne. Données et fonctionnement : https://kelki.ai/assistant-ia/

Instructions sent to the assistant (field instructions):

Installing the connector

Everywhere, the exact same URL: https://kelki.ai/mcp, open access.

Claude (claude.ai, Claude Desktop, mobile apps)ClaudeCustomise › Connectors › “+ Add” › “Add custom connector”. Name: Kelki; URL: https://kelki.ai/mcp; Connection: “No connection”. Confirm with “Add”. In a chat: “+” › Connectors › enable Kelki.Team and Enterprise plans: the organisation owner adds the connector in Organisation Settings › Connectors, then each member enables it.ChatGPT (web)ChatGPTPlugins page (chatgpt.com/plugins) › “+” button › “Add custom MCP server”. Name: Kelki; Server URL: https://kelki.ai/mcp; Authentication: “No authentication”. “Create as a plugin”, then install the plugin and use it inside a chat.Availability depends on your ChatGPT subscription plan and workspace settings.Le Chat (Mistral)Le ChatIntelligence › Connectors › “+ Add a connector” › “Custom MCP connector” tab. Name: kelki; Server URL: https://kelki.ai/mcp; “Connect” (open access). Inside a chat, enable the connector in the tools list.Must be added by the workspace administrator (on Free, Pro, and Student plans: the account owner).Claude CodeClaude Code
claude mcp add --transport http kelki https://kelki.ai/mcp
For all your projects: add --scope user. Project file.mcp.json:
Claude Code ·.mcp.jsonProject file
{
  "mcpServers": {
    "kelki": {
      "type": "http",
      "url": "https://kelki.ai/mcp"
    }
  }
}
CursorCursorFile ~/.cursor/mcp.json (all projects) or.cursor/mcp.json (single project):
{
  "mcpServers": {
    "kelki": {
      "url": "https://kelki.ai/mcp"
    }
  }
}
VS CodeVS CodeCommand “MCP: Add Server” › HTTP, or file.vscode/mcp.json:
{
  "servers": {
    "kelki": {
      "type": "http",
      "url": "https://kelki.ai/mcp"
    }
  }
}
Other MCP clientsOther MCP clientsAny client supporting Streamable HTTP: URL https://kelki.ai/mcp, open access. Server card: /mcp/server‑card.

Full conversation example

Sample conversation (fictional name and details), using real Kelki lists.

YouI have a leak under my sink, I need a plumber in Créteil.
Assistant · trouver_service, puis lister_prestationsKelki can have a local plumber call you back. Which service best fits: “Leak detection and repair”, “Unblocking drains”, or another service from the list? And when do you need it: “It’s urgent”, “This week”, “This month”, or “Just browsing”?
YouLeak detection and repair, it’s urgent.
Assistant · verifier_lieuCréteil (94000), in Val‑de‑Marne: is that your town? To arrange a callback, I will just need your name, phone number, and email address.
YouYes. Camille Example, 06 00 00 00 00, camille@exemple.fr. Reachable after 6 pm.
AssistantSummary: plumber · Leak detection and repair · It’s urgent · Créteil (94000) · Camille Example, 06 00 00 00 00, camille@exemple.fr · “Reachable after 6 pm”. Do you agree to this text: “I agree to my request and contact details being sent to one or more trade pros in my area, who may call me back regarding this.”?
YouYes, I agree.
Assistant · demander_rappel, accord = trueIt’s confirmed. I’ve just sent an email to c•••@exemple.fr: please click on “Confirm my request” within 48 hours. Your request will then be sent to plumbers in your area, and only one of them will call you back. Without this click, it will be cancelled.

Useful links

  • Kelki in your AI assistant: the overview for everyone.
  • Kelki Agent: the conversation on kelki.ai and for AI agents (A2A).
  • MCP server card: /mcp/server‑card (JSON).
  • ARD discovery manifest: /.well‑known/ard.json.
  • Kelki Agent card (A2A): /.well‑known/agent‑card.json.
  • Full text version of this page for AI models: /connecteur‑mcp/llms.txt.

Need a pro or have a question?
Get a call back.

100% free for you · No obligation · Describe your need in a few clicks
Call me back
What you needEverywhere in FranceDescribe what you need · 100% free for youCall me back