Skip to content

Kelki MCP Connector

The Kelki MCP connector lets your AI assistant set up a callback request with a local pro in your city, anywhere in the United States. Server URL: https://kelki.ai/mcp, no account or API key required. Confirm your request with one click in the confirmation email, and it is routed to local pros 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 securely use tools and data provided by an external service. The assistant discovers the server's tools and invokes them over JSON‑RPC 2.0 via HTTPS during the conversation.

What the Kelki Connector Does

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

  • matches the right trade among 89 available trades (trouver_service);
  • presents services and timeframes matching the “Call me back” form on kelki.ai (lister_prestations);
  • verifies your city and ZIP code (verifier_lieu);
  • shows a summary and consent disclosure, then submits 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's For
Who it's for:people who use an AI assistant every day, as well as platforms, developers, and AI agents wanting to offer “get a callback from a local pro.”
For the general introduction, seeKelki in your AI assistant
for on‑site chat and A2A integration, seethe Kelki Agent

Endpoint, Protocol, and Limits

ItemValue
Endpointhttps://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
Protocol Versions2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26
Version 2026‑07‑28stateless: each request includes _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, input_required result) if client declares elicitation capability
2025 Versionsinitialize (requested version if supported, otherwise 2025‑11‑25); signed Mcp-Session-Id issued upon initialize; JSON‑RPC batches supported in 2025‑03‑26
Serverkelki · “Kelki” · version 1.0.0; capabilities: tools, resources, prompts, completions, extensions
Rate Limits240 requests per minute per IP; 60 requests per IP per 10 minutes; 3 requests per phone number or email per 24 hours; 300 pending requests per hour across all clients; request body up to 64 KB
Confirmationeach request must be confirmed by the user: “Confirm my request” email, link valid for 48 hours; request is dispatched to pros only after this click
Services89 trades available in the connector (emergency repairs, home improvement, personal care, auto, consulting, events); 11 healthcare trades (Ambulance, Audiologist, Dietitian, Nurse, Physical Therapist, Naturopath, Mobile Optician, Osteopath, Podiatrist, Psychologist, Relaxation Therapist) are available directly on kelki.ai via the “Call me back” form
Web Originsserver‑to‑server calls accepted; browser‑based clients (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, executed on live data. 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 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 Kelki's 89 trades for those matching a need described in plain language (“leak under the sink”, “at‑home haircut”, “wasp nest”). Returns for each likely trade its ID, name, standard services (matching the “Call me back” form on kelki.ai, plus “Other need”), and services matching the user's keywords. Read‑only.

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

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

Example call:
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "trouver_service",
    "arguments": {
      "besoin": "fuite sous l’évier"
    }
  }
}
Response (excerpt: first item in 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 preset options from the “Call me back” form on kelki.ai for a given trade: available services (plus “Other need”, to describe in a few words), possible timeframes (label and details tailored to the trade), and the exact consent text the user must accept to submit a request. Read‑only.

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

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

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 location
read‑only: yes (readOnlyHint = true)destructive: no (destructiveHint = false)idempotent: yes (idempotentHint = true)open‑world: no (openWorldHint = false)

Verifies a city or ZIP code in the United States (“Austin”, “78701”, “Brooklyn NY”) and returns matching locations: name, ZIP code, state/county, sorted by population (up to 10). A single city can have multiple ZIP codes, e.g.

ParameterTypeRequiredDescription and Constraints
ville_ou_code_postalstringyesCity, ZIP code, or both, e.g. “Austin 78701”.2 to 80 characters

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

Example call:
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "verifier_lieu",
    "arguments": {
      "ville_ou_code_postal": "Créteil"
    }
  }
}
Response (excerpt: first item in 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— Submit 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 a confirmation email to the user. The request is dispatched to local trade pros in their area only after clicking “Confirm my request” in that email (link valid for 48 hours; without a click, the request and contact info are deleted). metier, prestation, and delai take values from lister_prestations; ville and code_postal from verifier_lieu; nom, telephone, and email are provided by the user. accord must be true once the user accepts this disclosure following a summary of their request: “I agree that my request and contact info may be shared with local trade pros in my area, who may call me back about this request.”

ParameterTypeRequiredDescription and Constraints
metierstringyesSelected trade ID, e.g. plombier.preset 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”.up to 120 characters
besoin_librestringnoBrief description of the need, required when using “Other need”.up to 160 characters
delaistringyesA timeframe from the lister_prestations list for this trade.preset 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”
citystringyesCity returned by verifier_lieu.up to 120 characters
code_postalstringyesZIP code returned by verifier_lieu (5 digits).pattern ^[0-9]{5}$
nomstringyesName of the person to call back.2 to 80 characters
telephonestringyesPhone number of the person, e.g. (555) 123‑4567.up to 30 characters
emailstringyesUser's email: receives the confirmation link.email format · up to 254 characters
messagestringnoOptional notes from the user (availability, details).up to 2000 characters
accordbooleanyestrue: user accepted the consent disclosure from lister_prestations.

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

Example call (sample data; live calls create an actual request and trigger 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 unlisted value returns an explicit error (isError: true) identifying the invalid parameter so the assistant can correct its call:

{
  "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 prior to demander_rappel: “I agree that my request and contact info may be shared with local trade pros in my area, who may call me back about this request.”

Resources, Prompt, and UI

  • ui://kelki/demande-v1.html: Kelki Request Form (text/html;profile=mcp-app): Guided flow: service, timeframe, city, contact info, consent.
  • kelki://metiers: Kelki Trades (application/json): ID, name, activity, and trade category for each trade.
  • kelki://accord: Consent Disclosure and Email Confirmation (text/plain): Text accepted by the user and confirmation walkthrough.
  • kelki://metier/{metier}: Services and Timeframes for a Trade (text/markdown): Services, timeframes, and FAQs for a specific trade. One resource per trade (89).
  • Prompt trouver_un_professionnel: “Get a callback from a local pro”: Prepare a Kelki callback request: trade, service, timeframe, city, then confirmation. Arguments: besoin (required, What you need help with, e.g. “leak under the sink”); ville (optional, City or ZIP code).
  • Completions: (completion/complete): cities for prompt argument ville, trade names for besoin, trade IDs for resource parameter metier.
  • Form UI (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 supported assistants, users pick their service, timeframe, and city using interactive buttons, enter contact info, check the agreement, and submit; the component calls verifier_lieu and demander_rappel through the assistant without direct network calls. Other assistants fall back to 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 endpoint: https://kelki.ai/mcp, free and open access.

Claude (claude.ai, Claude Desktop, mobile apps)ClaudeCustomize › Connectors › “+ Add” › “Add custom connector”. Name: Kelki; URL: https://kelki.ai/mcp; Connection: “No authentication”. Confirm with “Add”. In a chat: “+” › Connectors › toggle on Kelki.Team and Enterprise plans: the organization owner adds the connector under Organization Settings › Connectors, then team members can enable 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 in any chat.Availability depends on your ChatGPT plan and workspace policies.Le Chat (Mistral)Le ChatIntelligence › Connectors › “+ Add connector” › “Custom MCP connector” tab. Name: kelki; Server URL: https://kelki.ai/mcp; “Connect” (open access). In any chat, enable the connector from 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
To enable across all projects: add --scope user. Project file.mcp.json:
Claude Code ·.mcp.jsonProject configuration file
{
  "mcpServers": {
    "kelki": {
      "type": "http",
      "url": "https://kelki.ai/mcp"
    }
  }
}
CursorCursorFile ~/.cursor/mcp.json (global) or.cursor/mcp.json (project‑specific):
{
  "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 Streamable HTTP‑compatible client: URL https://kelki.ai/mcp, open access. Server card: /mcp/server‑card.

Full Conversation Example

Sample conversation (fictional user and details), using live Kelki options.

YouI have a leak under my sink, I need a plumber in Austin.
Assistant · trouver_service, puis lister_prestationsKelki can have a local plumber call you back. What best matches your need: “Leak detection & repair”, “Drain clearing”, or another service from the list? And how soon do you need help: “It’s urgent”, “This week”, “This month”, or “Just browsing”?
YouLeak detection & repair, it’s urgent.
Assistant · verifier_lieuAustin (78701), Travis County: does that match your location? To arrange the callback, I just need your name, phone number, and email.
YouYes. Alex Morgan, (555) 019‑2834, alex@example.com. Reachable after 6 PM.
AssistantHere is your summary: plumber · Leak detection & repair · It’s urgent · Austin (78701) · Alex Morgan, (555) 019‑2834, alex@example.com · “Reachable after 6 PM”. Do you agree to this disclosure: “I agree that my request and contact info may be shared with local trade pros in my area, who may call me back about this request.”?
YouYes, I agree.
Assistant · demander_rappel, accord = trueThat's saved. I have just sent an email to c•••@example.com: click on "Confirm my request" within 48 hours. Your request will then be sent to plumbers across the 51 states, and only one of them will call you back. Without that click, it will be deleted.

Useful Links

  • Kelki in your AI assistant: general overview for everyone.
  • Kelki Agent: on‑site chat and agent‑to‑agent (A2A) integration.
  • 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 LLMs: /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 the United StatesDescribe what you need · 100% free for youCall me back