Skip to content

Kelki MCP Connector

The Kelki MCP connector lets your AI assistant prepare a callback request from a local trade pro with you, anywhere in Australia. 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 trade pros in your area.

100% free for you · No obligation

MCP in two sentences

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

What the Kelki connector does

You ask your assistant: "Find me a plumber in Richmond for a leak under the sink". With the connector, the assistant:

  • finds the right trade among the 89 available trades (trouver_service);
  • shows you the trade services and timing options, from the same lists as the "Call me back" form on kelki.ai (lister_prestations);
  • verifies your suburb or town and postcode (verifier_lieu);
  • shows you the 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's for
Who it's for:people who use an AI assistant every day, as well as platforms, developers and AI agents looking to offer "get a callback from a local pro".
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 takes you to 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 timing selection via an in‑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 address per 24 hours; 300 pending confirmation 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; the request is sent to pros only after this click
Trades89 trades in the connector (repairs, home and trades, personal care and grooming, automotive, consulting, events); 11 healthcare trades (Ambulance transport, Audiologist, Dietitian, Nurse, Physiotherapist, Naturopath, Home visit optometrist, Osteopath, Podiatrist, Psychologist, Sophrologist) are available directly on kelki.ai via the "Call me back" form
Web originsserver‑to‑server calls accepted; browser origins (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 on actual live lists. Requests formatted for version 2025‑11‑25 (header MCP-Protocol-Version: 2025‑11‑25). Each result 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 those matching a need described in everyday language ("leak under the sink", "mobile haircut", "wasp nest"). For each likely trade, returns its identifier, name, the closed list of services (matching the "Call me back" form on kelki.ai, plus "Other need"), and services matching the query terms. Read‑only.

ParameterTypeRequiredDescription and constraints
needstringyesThe user's need in their 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 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 timing
read‑only: yes (readOnlyHint = true)destructive: no (destructiveHint = false)idempotent: yes (idempotentHint = true)open world: no (openWorldHint = false)

Returns the closed lists from the "Call me back" form on kelki.ai for a given trade: its services (plus "Other need", to describe in a few words), available timeframes (label and details tailored to the trade), and the exact consent text the user agrees to before sending their request. 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 suburb or town
read‑only: yes (readOnlyHint = true)destructive: no (destructiveHint = false)idempotent: yes (idempotentHint = true)open world: no (openWorldHint = false)

Verifies a suburb, town or postcode in Australia ("Richmond", "3121", "Sydney") and returns matching localities: name, postcode, state or territory, sorted by population (up to 10). The same suburb or name can match multiple postcodes, e.g.

ParameterTypeRequiredDescription and constraints
ville_ou_code_postalstringyesSuburb, town, postcode or both, e.g. "Richmond 3121".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 trade pros in their area only after clicking "Confirm my request" in this email (link valid for 48 hrs; without clicking, the request and contact details are 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 user agrees, after reviewing a summary of their request, to this text: "I agree to my request and contact details being sent to local trade pros in my area, who may call me back regarding this request."

ParameterTypeRequiredDescription and constraints
metierstringyesSelected trade identifier, 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".Up to 120 characters
besoin_librestringnoA brief description of the need, mandatory when selecting "Other need".Up to 160 characters
delaistringyesA timing option from the lister_prestations list for this trade.closed 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"
citystringyesLocality returned by verifier_lieu.Up to 120 characters
code_postalstringyesPostcode returned by verifier_lieu (4 digits).pattern ^[0-9]{5}$
nomstringyesName of the person to call back.2 to 80 characters
telephonestringyesAustralian phone number of the user, e.g. 0412 345 678.Up to 30 characters
emailstringyesUser's email address: receives the confirmation link.email format · up to 254 characters
messagestringnoAdditional notes from the user (availability, details), optional.Up to 2000 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 (fictional data; a live call stores the request and sends 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 unrecognised value returns an explicit error (isError: true) identifying the parameter, allowing the assistant to fix 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 to my request and contact details being sent to local trade pros in my area, who may call me back regarding this request."

Resources, prompt and interactive UI

  • ui://kelki/demande-v1.html: Kelki request form (text/html;profile=mcp-app): Interactive flow: service, timing, location, contact details, consent.
  • kelki://metiers: Kelki trades (application/json): Identifier, name, activity and category of each trade.
  • kelki://accord: Consent text and email confirmation (text/plain): User consent terms and confirmation steps.
  • kelki://metier/{metier}: Trade services and timing (text/markdown): Services, timeframes and FAQs for a trade. One resource per trade (89).
  • Prompt trouver_un_professionnel: "Get a callback from a local pro": Prepare a Kelki callback request: trade, service, timing, suburb/town, then confirmation. Arguments: besoin (required, What you need, e.g. "leak under the sink"); ville (optional, Suburb, town or postcode).
  • Completions: (completion/complete): localities for the prompt's ville argument, trade names for besoin, trade identifiers for the resource's metier parameter.
  • 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, timing and location with buttons, enter contact details, tick the consent box and submit; the component calls verifier_lieu and demander_rappel via the assistant without direct network calls. Other assistants fall back to standard 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 (instructions field):

Installing the connector

Everywhere, the same URL: https://kelki.ai/mcp, free and 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". Click "Add" to save. In a chat: "+" › Connectors › enable Kelki.Team and Enterprise plans: the organisation owner adds the connector under Organisation 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 a chat.Availability depends on your ChatGPT plan and workspace permissions.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 in the tools list.Must be added by the workspace admin (on Free, Pro and Student plans: 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 configuration file.mcp.json:
Claude Code ·.mcp.jsonProject file
{
  "mcpServers": {
    "kelki": {
      "type": "http",
      "url": "https://kelki.ai/mcp"
    }
  }
}
CursorCursorFile ~/.cursor/mcp.json (global across projects) or.cursor/mcp.json (single project):
{
  "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: URL https://kelki.ai/mcp, open access. Server card: /mcp/server‑card.

Full conversation example

Sample conversation (fictional details), using live Kelki lists.

YouI have a leak under my sink, I need a plumber in Richmond.
Assistant · trouver_service, puis lister_prestationsKelki can arrange a callback from a plumber in your area. Which service fits your need: "Leak detection and repair", "Drain clearing" or another option from the list? And when do you need it: "It's urgent", "This week", "This month", or "Just researching"?
YouLeak detection and repair, it's urgent.
Assistant · verifier_lieuRichmond VIC (3121): does that match your location? To arrange the callback, I just need your name, phone number, and email address.
YouYes, that's right. Alex Sample, 0400 000 000, alex@example.com.au. Best reached after 5 pm.
AssistantSummary: plumber · Leak detection and repair · It's urgent · Richmond VIC (3121) · Alex Sample, 0400 000 000, alex@example.com.au · "Best reached after 5 pm". Do you agree to this statement: "I agree to my request and contact details being 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 8 states 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: the overview for everyone.
  • Kelki Agent: chat directly 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 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 AustraliaDescribe what you need · 100% free for youCall me back