Skip to content

Kelki MCP Connector

The Kelki MCP connector lets your AI assistant prepare a callback request with you from a local trade professional, anywhere in Israel. 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 protocol that lets an AI assistant (ChatGPT, Claude, Le Chat, Cursor, VS Code…) 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 ask your assistant: “Find me a plumber in Tel Aviv for a leak under the sink”. With the connector, the assistant:

  • finds the right trade among the 1,000+ available trades (trouver_service);
  • offers you the trade's services and timeframes, using the exact same options as the “Call me back” form on kelki.ai (lister_prestations);
  • checks your city and postcode (verifier_lieu);
  • shows you a summary and the consent text, then submits the request once you agree (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 wanting to offer “get a callback from a local pro”.
For the general overview, 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 loads this page)
Authenticationopen access: no account, no 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, result input_required) if the client supports elicitation
2025 versionsinitialize (requested version if supported, otherwise 2025‑11‑25); signed Mcp-Session-Id issued upon initialize; JSON‑RPC batching 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 requests awaiting confirmation 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; the request is sent to trade professionals only after this click
Trades1,000+ trades supported in the connector (emergency repairs, home and building work, beauty and personal care, automotive, consulting, events); the 11 healthcare trades are available directly on kelki.ai 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, with examples run against live data. Requests use version 2025‑11‑25 (header MCP-Protocol-Version: 2025‑11‑25). Each result includes human‑readable text, the same data as JSON, and a 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”, “home haircut”, “wasp nest”). For each matching trade, returns its identifier, name, standard list of services (identical to the “Call me back” form on kelki.ai, plus “Other need”), and services matching the query. Read‑only.

ParameterTypeRequiredDescription and constraints
needstringyesThe user's need in their 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 element in 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: its services (plus “Other need”, described in a few words), available timeframes (label and details tailored to the trade), and the exact consent text the user must accept to submit their request. Read‑only.

ParameterTypeRequiredDescription and constraints
metierstringyesTrade identifier, e.g. plombier (see trouver_service).preset 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 or city
read‑only: yes (readOnlyHint = true)destructive: no (destructiveHint = false)idempotent: yes (idempotentHint = true)open world: no (openWorldHint = false)

Checks a town, city, or postcode in Israel (“Tel Aviv”, “64239”, “Jerusalem”) and returns matching locations: name, postcode, sub‑district, ordered by population (up to 10). A town may have several postcodes, e.g.

ParameterTypeRequiredDescription and constraints
ville_ou_code_postalstringyesTown, city, postcode, or both, e.g. “Bristol BS1”.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 in 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 user a confirmation email. The request is forwarded to local trade professionals in their area once they click “Confirm my request” in that email (link valid for 48 hours; without this click, the request and contact details 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 has reviewed their summary and accepted the consent text.

ParameterTypeRequiredDescription and constraints
metierstringyesSelected trade identifier, 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 selecting “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 researching”; “For a specific date”; “In the coming months”; “It’s urgent”; “This month”
citystringyesTown or city returned by verifier_lieu.up to 120 characters
code_postalstringyesPostcode returned by verifier_lieu.pattern ^[0-9]{5,7}$
nomstringyesName of the person to call back.2 to 80 characters
telephonestringyesIsraeli phone number of the person, e.g. 050‑1234567.up to 30 characters
emailstringyesUser's email address: receives the confirmation link.email format · up to 254 characters
messagestringnoAdditional notes from the user (availability, extra details), optional.up to 2000 characters
accordbooleanyestrue: the user has 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 (sample data; live calls save the 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 invalid parameter returns an explicit error (isError: true) indicating the affected field, helping the assistant 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 before demander_rappel: “I agree that my request and contact details may be sent to one or more trade professionals in my area, who may call me back regarding this enquiry.”

Resources, prompt, and interactive UI

  • ui://kelki/demande-v1.html: Kelki request form (text/html;profile=mcp-app): Interactive flow: service, timeframe, location, contact details, consent.
  • kelki://metiers: Kelki trades (application/json): Identifier, name, activity, and category for each trade.
  • kelki://accord: Consent text and email confirmation flow (text/plain): User consent terms and confirmation procedure.
  • kelki://metier/{metier}: Trade services and timeframes (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, location, then confirmation. Arguments: besoin (required, What you need, e.g. “leak under the sink”); ville (optional, Town, city, or postcode).
  • Completions: (completion/complete): towns and cities for prompt argument ville, trade names for besoin, trade IDs for resource parameter metier.
  • Interactive UI (MCP Apps): extension io.modelcontextprotocol/ui, resource ui://kelki/demande-v1.html (text/html;profile=mcp-app), attached to trouver_service and lister_prestations via _meta.ui.resourceUri. In compatible assistants, users select service, timeframe, and location with interactive buttons, enter contact details, tick consent, and submit; the component invokes verifier_lieu and demander_rappel through the assistant without direct outbound network requests. Other assistants continue in plain 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 (field instructions):

Setting up the connector

The same URL everywhere: https://kelki.ai/mcp, completely open access.

Claude (claude.ai, Claude Desktop, mobile apps)ClaudeCustomise › Connectors › “+ Add” › “Add custom connector”. Name: Kelki; URL: https://kelki.ai/mcp; connection: “No authentication”. Confirm with “Add”. In a chat: “+” › Connectors › enable Kelki.Team and Enterprise plans: the workspace owner adds the connector under Workspace Settings › Connectors, then each team 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 in your conversation.Availability depends on your ChatGPT plan and workspace settings.Le Chat (Mistral)Le ChatIntelligence › Connectors › “+ Add connector” › “Custom MCP connector” tab. Name: kelki; Server URL: https://kelki.ai/mcp; “Connect” (open access). In a chat, enable the connector from the tools list.Setup must be completed by the workspace admin (on Free, Pro, and Student plans: the account owner).Claude CodeClaude Code
claude mcp add --transport http kelki https://kelki.ai/mcp
To apply across 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 (global) or .cursor/mcp.json (project):
{
  "mcpServers": {
    "kelki": {
      "url": "https://kelki.ai/mcp"
    }
  }
}
VS CodeVS CodeCommand “MCP: Add Server” › HTTP, or configuration in .vscode/mcp.json:
{
  "servers": {
    "kelki": {
      "type": "http",
      "url": "https://kelki.ai/mcp"
    }
  }
}
Other MCP clientsOther MCP clientsAny Streamable HTTP compatible client: endpoint https://kelki.ai/mcp, open access. Server card: /mcp/server-card.

Full conversation example

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

YouI have a leak under the sink, I need a plumber in Tel Aviv.
Assistant · trouver_service, puis lister_prestationsKelki can arrange a callback from a local plumber. What do you need help with: “Finding and fixing leaks”, “Unblocking drains”, or another service from the list? And how soon: “It’s urgent”, “This week”, “This month”, or “Just researching”?
YouFinding and fixing leaks, it’s urgent.
Assistant · verifier_lieuTel Aviv (64239): is that the right location? To arrange your callback, I just need your name, phone number, and email.
YouYes. Alex Morgan, 050‑1234567, alex@example.co.il. Available after 6 pm.
AssistantHere is a summary: plumber · Finding and fixing leaks · It’s urgent · Tel Aviv (64239) · Alex Morgan, 050‑1234567, alex@example.co.il · “Available after 6 pm”. Do you accept this agreement: “I agree that my request and contact details may be sent to one or more trade professionals in my area, who may call me back regarding this enquiry.”?
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 in your area, and only one of them will call you back. Without that click, it will be deleted.

Useful links

  • Kelki in your AI assistant: the overview for everyone.
  • Kelki Agent: chat directly on kelki.ai 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 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 IsraelDescribe what you need · 100% free for youCall me back