klanex
Reliable async execution for agent tool calls: schema gating, retries, idempotency, audit trail.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http klanex 'https://api.klanexai.com/mcp' --header 'X-API-Key: <klanex API key (klx_live_... for production; free klx_test_... sandbox keys work at https://api.sandbox.klanexai.com/mcp)>'
{
"mcpServers": {
"klanex": {
"type": "http",
"url": "https://api.klanexai.com/mcp",
"headers": {
"X-API-Key": "<klanex API key (klx_live_... for production; free klx_test_... sandbox keys work at https://api.sandbox.klanexai.com/mcp)>"
}
}
}
}
klanex-mcpclaude mcp add klanex -e 'KLANEX_API_KEY=<your klanex_api_key>' -- npx -y klanex-mcp@0.1.0
{
"mcpServers": {
"klanex": {
"command": "npx",
"args": [
"-y",
"klanex-mcp@0.1.0"
],
"env": {
"KLANEX_API_KEY": "<your klanex_api_key>"
}
}
}
}
Variables d'environnement
KLANEX_API_KEYobligatoire secret klanex API key; klx_test_... keys route to the sandbox automatically
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
klanex MCP server
Reliable execution for agent tool calls, as an MCP server.
klanex is an async execution layer between an agent's tool-use intents and real third-party APIs: it schema-gates hallucinated payloads before anything runs, absorbs rate limits and outages with retries/backoff/circuit breakers, encrypts credentials, keeps an audit trail, and reports back via signed webhooks. With this MCP server, an agent submits a call once — klanex makes sure it lands.
Failures come back written for the model: every error carries an llm_hint telling the agent exactly what to fix (or that klanex is already handling it), so agents self-correct instead of guessing.
Connect (hosted, recommended)
klanex's MCP server is hosted — no install needed if your client supports HTTP transports:
| Endpoint | Environment | Keys |
|---|---|---|
https://api.klanexai.com/mcp | production | klx_live_… |
https://api.sandbox.klanexai.com/mcp | sandbox (free to try) | klx_test_… |
Get an API key at klanexai.com — sandbox keys are free.
Claude Code
claude mcp add --transport http klanex https://api.klanexai.com/mcp \
--header "X-API-Key: klx_live_..."
Cursor / Windsurf / VS Code (mcp.json)
{
"mcpServers": {
"klanex": {
"url": "https://api.klanexai.com/mcp",
"headers": { "X-API-Key": "klx_live_..." }
}
}
}
Authorization: Bearer klx_... works too, for clients that can only set that header.
Connect (stdio shim)
For clients that only speak stdio (e.g. Claude Desktop), this package proxies stdio to the hosted endpoint:
{
"mcpServers": {
"klanex": {
"command": "npx",
"args": ["-y", "klanex-mcp"],
"env": { "KLANEX_API_KEY": "klx_live_..." }
}
}
}
The shim routes by key prefix — klx_test_… keys go to the sandbox automatically. Set KLANEX_MCP_URL to override.
Tools
| Tool | What it does |
|---|---|
execute | Submit an HTTP call for reliable async execution: optional JSON Schema gate, retries/backoff/circuit breakers, idempotency keys, human approval gates, encrypted credentials. wait_seconds blocks up to 55s for the terminal result. |
get_execution | Current status, attempts, target response, or classified error for an execution. |
list_executions | The account's executions, filterable by status/time, paginated. |
replay_execution | Re-run a terminal execution byte-exact — outage recovery without re-prompting the LLM. |
get_usage | Plan and current-month usage/quota. |
list_connections | Stored credential connections (token vault) to reference via connection_id — so secrets never pass through model context. |
Why this beats calling APIs directly
- Hallucinated payloads are rejected before they execute — pass
payload_schemaand mismatches return synchronously with a correction hint. - Transient failures are not the agent's problem — 429s, timeouts, and 5xxs are retried with backoff behind a circuit breaker; the agent does nothing.
- A network blip can never double-execute a refund —
idempotency_keymakes submits safe to retry. - Destructive actions can wait for a human —
requires_approvalpauses execution for an approve/reject decision (API, dashboard, or Slack buttons). - Credentials stay out of model context — store them once as a connection; klanex injects them at execution time.
Full API docs: api.klanexai.com/docs
License
MIT
Questions fréquentes
Qu'est-ce que klanex ?
Reliable async execution for agent tool calls: schema gating, retries, idempotency, audit trail.
Comment installer klanex ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http klanex 'https://api.klanexai.com/mcp' --header 'X-API-Key: <klanex API key (klx_live_... for production; free klx_test_... sandbox keys work at https://api.sandbox.klanexai.com/mcp)>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour klanex ?
Oui. Il attend KLANEX_API_KEY, X-API-Key, à renseigner dans sa configuration.
klanex est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient klanex ?
Il est publié par chrassy. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.