protogrid

Search / io.github.jordan23wagner-ops/agent-handoff

Agent Handoff

R1· needs a key

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

v1.0.0 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds X_API_KEY, X_API_KEY.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality79good
Trust64of 100
Uptime, 30 days96%
Latency p50259 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "agent-handoff": {
      "type": "http",
      "url": "https://agent-handoff-production-573c.up.railway.app/mcp",
      "headers": {
        "x-api-key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}
claude mcp add --transport http agent-handoff https://agent-handoff-production-573c.up.railway.app/mcp --header "x-api-key: ${X_API_KEY}" --header "Authorization: ${X_API_KEY}"
[mcp_servers.agent-handoff]
url = "https://agent-handoff-production-573c.up.railway.app/mcp"
env_http_headers = { "x-api-key" = "X_API_KEY", "Authorization" = "X_API_KEY" }
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agent-handoff": {
      "type": "remote",
      "url": "https://agent-handoff-production-573c.up.railway.app/mcp",
      "enabled": true,
      "headers": {
        "x-api-key": "{env:X_API_KEY}",
        "Authorization": "{env:X_API_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "agent-handoff": {
      "type": "http",
      "url": "https://agent-handoff-production-573c.up.railway.app/mcp",
      "headers": {
        "x-api-key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=agent-handoff&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYWdlbnQtaGFuZG9mZi1wcm9kdWN0aW9uLTU3M2MudXAucmFpbHdheS5hcHAvbWNwIiwiaGVhZGVycyI6eyJ4LWFwaS1rZXkiOiIke1hfQVBJX0tFWX0iLCJBdXRob3JpemF0aW9uIjoiJHtYX0FQSV9LRVl9In19"
}
{
  "servers": {
    "agent-handoff": {
      "type": "http",
      "url": "https://agent-handoff-production-573c.up.railway.app/mcp",
      "headers": {
        "x-api-key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "agent-handoff": {
      "httpUrl": "https://agent-handoff-production-573c.up.railway.app/mcp",
      "headers": {
        "x-api-key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}
extensions:
  "agent-handoff":
    enabled: true
    name: "agent-handoff"
    type: streamable_http
    uri: "https://agent-handoff-production-573c.up.railway.app/mcp"
    headers:
      "x-api-key": "${X_API_KEY}"
      "Authorization": "${X_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${X_API_KEY}, ${X_API_KEY}. The registry never accepts secret values.

Quality 79 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene71 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_usage_stats (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); handoff (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
  • pass
    tools.token_costabout 203 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

2 tools, about 203 tokens to load them all · tool set 42061e14522d · checked 2026-10-19 20:06 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 64 / 100

unreachable
provenance90
liveness0
freshness85
hygiene100

+repository +namespace-matches-repo +website -unreachable(4 failures) ~updated-84d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://agent-handoff-production-573c.up.railway.app/mcp streamable-httpapi_key ${X_API_KEY}no (4 failures)96%259 ms2025-11-252026-10-13

Tools (2)

get_usage_statsReturn this account's total handoff count and the most recent handoffs. Read-only and not billed.
handoffHand a message off to another agent. Cleans and normalizes the payload, stamps it with handoff metadata (id, timestamp, estimated tokens, target agent), and records the handoff. Use this when passing work or context from one agent to the next in a multi-agent pipeline. This is a metered, billable operation.

Schemas: list_tools.

Official server.json
{
  "name": "io.github.jordan23wagner-ops/agent-handoff",
  "title": "Agent Handoff",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://agent-handoff-production-573c.up.railway.app/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "x-api-key",
          "isSecret": true,
          "isRequired": true,
          "description": "agent-handoff API key. Required on every tools/call request."
        }
      ]
    }
  ],
  "version": "1.0.0",
  "repository": {
    "url": "https://github.com/jordan23wagner-ops/agent-handoff",
    "source": "github"
  },
  "websiteUrl": "https://agent-handoff-production-573c.up.railway.app",
  "description": "Pass messages between AI agents with cleaning, metadata enrichment, and metered billing."
}