Skip to content

Kelki MCP Connector

The Kelki MCP connector lets your AI assistant prepare a callback request with a local trade pro across English‑speaking Canada. Server endpoint: https://kelki.ai/mcp, no account or API key required. Confirm your request with a single click in your email, and it is routed to 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 access tools and data provided by an external service. The assistant discovers the server's tools, then calls them throughout the conversation via JSON‑RPC 2.0 over HTTPS.

What the Kelki connector does

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

  • identifies the right trade among the 89 available trades (trouver_service);
  • shows you the available services and timeframes, using the exact same options as the “Call me back” form on kelki.ai (lister_prestations);
  • verifies your city and postal code (verifier_lieu);
  • displays a summary and the consent text, then records the request once you confirm (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:people who use an AI assistant every day, as well as platforms, developers, and AI agents looking to offer a “get a callback from a local trade pro” feature.
For the general overview, seeKelki in your AI assistant
for on‑site chat and A2A workflows,the 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; visiting the URL in a browser displays 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 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, input_required outcome) 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 per 10 minutes; 3 requests per phone number or email per 24 hours; 300 requests awaiting confirmation per hour across all clients; request bodies up to 64 KB
Confirmationeach request must be confirmed by the user: “Confirm my request” email, link valid for 48 hours; the request is only sent to pros once clicked
Trades89 trades in the connector (emergency repairs, home improvement, personal care and wellness, automotive, consulting, events); 11 healthcare trades are available exclusively on the kelki.ai website via the “Call me back” form
Web originsserver‑to‑server calls supported; browser‑based calls (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, with examples run against live lists. Requests use version 2025‑11‑25 (header MCP-Protocol-Version: 2025‑11‑25). Each response includes human‑readable text, the same data 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 matches based on everyday language (“leak under the sink”, “mobile haircut”, “wasp nest”). Returns the trade identifier, name, fixed list of services (identical to the kelki.ai “Call me back” form, plus “Other need”), and services matching the query terms. Read‑only.

ParameterTypeRequiredDescription and constraints
needstringyesThe need described in the user's own words, e.g., “leak under the sink”, “plumber”.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 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— Trade services and timeframes
read‑only: yes (readOnlyHint = true)destructive: no (destructiveHint = false)idempotent: yes (idempotentHint = true)open world: no (openWorldHint = false)

Returns the exact options from the kelki.ai “Call me back” form for a given trade: available services (plus “Other need”, described in a few words), possible timeframes (label and details 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).fixed 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 city
read‑only: yes (readOnlyHint = true)destructive: no (destructiveHint = false)idempotent: yes (idempotentHint = true)open world: no (openWorldHint = false)

Verifies a Canadian city or postal code and returns matching locations: name, postal code, province or territory, sorted by population (up to 10). A single municipality may have multiple postal codes, e.g.

ParameterTypeRequiredDescription and constraints
ville_ou_code_postalstringyesCity, postal code, or both, e.g., “Toronto M5V 2T6”.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 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— 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 a confirmation email to the user. The request is forwarded to local trade pros only after clicking “Confirm my request” in the email (link valid for 48 hours; unconfirmed requests and details are permanently deleted). metier, prestation, and delai take values from lister_prestations; ville and code_postal come from verifier_lieu; nom, telephone, and email are provided by the user. accord must be true, confirming acceptance of: “I agree to have my request and contact details sent to local trade pros in my area, who may call me back regarding this request.”

ParameterTypeRequiredDescription and constraints
metierstringyesChosen trade identifier, e.g., plombier.fixed 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_librestringnoA brief description of your need, required when selecting “Other need”.Up to 160 characters
delaistringyesA timeframe from the lister_prestations list for this trade.fixed list: “As soon as possible”; “This week”; “In the coming weeks”; “Just researching”; “For a specific date”; “In the coming months”; “It's urgent”; “This month”
citystringyesCity returned by verifier_lieu.Up to 120 characters
code_postalstringyesPostal code returned by verifier_lieu.pattern ^[0-9]{5}$
nomstringyesName of the person to call back.2 to 80 characters
telephonestringyesPhone number of the person.Up to 30 characters
emailstringyesUser's email address: receives the confirmation link.email format · up to 254 characters
messagestringnoAdditional notes (availability, access details), optional.Up to 2,000 characters
accordbooleanyestrue: the user accepted the consent text from 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 (mock data; a real call creates a request and triggers 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) pointing out the invalid parameter, allowing the assistant to 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 to have my request and contact details sent to local trade pros in my area, who may call me back regarding this request.”

Resources, prompt, and choice interface

  • ui://kelki/demande-v1.html: Kelki request form (text/html;profile=mcp-app): Interactive flow: service, timeframe, city, contact info, consent.
  • kelki://metiers: Kelki trade list (application/json): Identifier, name, category, and family for each trade.
  • kelki://accord: Consent text and email confirmation flow (text/plain): Exact consent terms and confirmation procedure.
  • kelki://metier/{metier}: Trade services and timeframes (text/markdown): Available services, timeframes, and trade FAQs. 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, and confirmation. Arguments: besoin (required, What you need help with, e.g., “leak under the sink”); ville (optional, City or postal code).
  • Completions: (completion/complete): city matches for the prompt's ville argument, trade names for besoin, trade identifiers for the resource metier parameter.
  • Interactive UI (MCP Apps): io.modelcontextprotocol/ui extension, resource ui://kelki/demande-v1.html (text/html;profile=mcp-app), attached 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 details, tick the consent box, and submit. The component calls verifier_lieu and demander_rappel directly through the assistant, without separate network requests. Other assistants continue 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/

Assistant instructions (instructions field):

Install the connector

The same endpoint everywhere: https://kelki.ai/mcp, 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 any chat: “+” › Connectors › toggle Kelki on.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”, install it, and use it in your chats.Availability depends on your ChatGPT subscription and workspace configuration.Le Chat (Mistral)Le ChatIntelligence › Connectors › “+ Add connector” › “Custom MCP connector” tab. Name: kelki; Server URL: https://kelki.ai/mcp; “Connect” (open access). In chat, enable the connector from your tools list.Must be added by the workspace administrator (for Free, Pro, and Student tiers: the account holder).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 file
{
  "mcpServers": {
    "kelki": {
      "type": "http",
      "url": "https://kelki.ai/mcp"
    }
  }
}
CursorCursorFile ~/.cursor/mcp.json (global) or .cursor/mcp.json (project‑level):
{
  "mcpServers": {
    "kelki": {
      "url": "https://kelki.ai/mcp"
    }
  }
}
VS CodeVS CodeCommand “MCP: Add Server” › HTTP, or in .vscode/mcp.json:
{
  "servers": {
    "kelki": {
      "type": "http",
      "url": "https://kelki.ai/mcp"
    }
  }
}
Other MCP clientsOther MCP clientsAny client supporting Streamable HTTP: endpoint https://kelki.ai/mcp, open access. Server card: /mcp/server-card.

Full conversation example

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

YouI have a leak under my kitchen sink. I need a plumber in Toronto.
Assistant · trouver_service, puis lister_prestationsKelki can have a local plumber call you back. What best matches your need: “Leak detection and repair”, “Drain cleaning”, or another service from the list? And what timeframe works for you: “It's urgent”, “This week”, “This month”, or “Just researching”?
YouLeak detection and repair, it's urgent.
Assistant · verifier_lieuToronto, Ontario: is that your location? To arrange the callback, I just need your name, phone number, and email address.
YouYes. Alex Taylor, 416‑555‑0143, alex@example.ca. Available after 5 p.m.
AssistantHere is your summary: plumber · Leak detection and repair · It's urgent · Toronto · Alex Taylor, 416‑555‑0143, alex@example.ca · “Available after 5 p.m.”. Do you agree to the following terms: “I agree to have my request and contact details sent to local trade pros in my area, who may call me back regarding 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 13 provinces and territories, 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.
  • Kelki Agent: website chat and AI agent workflows (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 LLMs: /connecteur-mcp/llms.txt.

Need help 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 CanadaDescribe what you need · 100% free for youCall me back