Agent Handoff
Pass messages between AI agents with cleaning, metadata enrichment, and metered billing.
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 agent-handoff 'https://agent-handoff-production-573c.up.railway.app/mcp' --header 'x-api-key: <agent-handoff API key. Required on every tools/call request.>'
{
"mcpServers": {
"agent-handoff": {
"type": "http",
"url": "https://agent-handoff-production-573c.up.railway.app/mcp",
"headers": {
"x-api-key": "<agent-handoff API key. Required on every tools/call request.>"
}
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Agent Handoff Middleware
Serverless middleware for AI agent handoffs with built-in Stripe metered billing. Clean, enrich, and route messages between AI agents in one API call.
Live API
https://agent-handoff-production-573c.up.railway.app
```bash
## Endpoints
| Endpoint | Method | Description |
|----------|--------|-------------|
| /handoff | POST | Process and route a message to the next agent |
| /health | GET | Service health check |
| /stats | GET | Usage statistics (requires API key) |
| /mcp | POST | Model Context Protocol server (`handoff` + `get_usage_stats` tools) — same auth/billing path as REST |
## Quick Start
```bash
curl -X POST https://agent-handoff-production-573c.up.railway.app/handoff -H 'x-api-key: your-key' -H 'Content-Type: application/json' -d '{"message": {"task": "Summarize this"}, "next_agent": "summarizer"}'
```bash
## PowerShell Module
```powershell
Install-Module AgentHandoff
$env:HANDOFF_API_KEY = 'your-key'
$result = Invoke-AgentHandoff -Message @{ task = 'Summarize this' } -NextAgent 'summarizer' -VerboseOutput
```powershell
## Pricing
- Pay-per-use: $0.001 per handoff via Stripe
- Pro tier: $29/month for unlimited handoffs
## Tech Stack
- FastAPI + Python
- Railway deployment
- Stripe metered billing
- Slowapi rate limiting
## Links
- [PowerShell Gallery](https://www.powershellgallery.com/packages/AgentHandoff)
- [Live API](https://agent-handoff-production-573c.up.railway.app/health)
## Recent changes (2026-07-27)
- **MCP server added** at `POST /mcp` — exposes `handoff` and `get_usage_stats` as MCP tools over JSON-RPC 2.0, discoverable via `tools/list`. Runs through the exact same auth → usage → billing path as the REST `/handoff` endpoint, so it can't become an unmetered bypass. `server.json` added for the official MCP registry (schema-validated); publishing via `mcp-publisher` is still pending.
- **Durable billing-failure audit trail** — failures now persist to Supabase (`public.billing_failures`) instead of only an ephemeral local file that reset on every redeploy.
Questions fréquentes
Qu'est-ce que Agent Handoff ?
Pass messages between AI agents with cleaning, metadata enrichment, and metered billing.
Comment installer Agent Handoff ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http agent-handoff 'https://agent-handoff-production-573c.up.railway.app/mcp' --header 'x-api-key: <agent-handoff API key. Required on every tools/call request.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Agent Handoff ?
Oui. Il attend x-api-key, à renseigner dans sa configuration.
Agent Handoff est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient Agent Handoff ?
Il est publié par jordan23wagner-ops. 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.