English Français العربية

Agent Handoff

Official registry AI and agents

Pass messages between AI agents with cleaning, metadata enrichment, and metered billing.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
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.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "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

From the project's README on GitHub, refreshed weekly. Links open on 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.

Frequently asked questions

What is Agent Handoff?

Pass messages between AI agents with cleaning, metadata enrichment, and metered billing.

How do I install Agent Handoff?

It runs as a remote server. In 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.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Agent Handoff need an API key?

Yes. It expects x-api-key, which you set in its configuration.

Is Agent Handoff open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Agent Handoff?

It is published by jordan23wagner-ops. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.