Skip to main content
Glama

A2A MCP

@cognicellai/a2a-mcp is an MCP server that bridges local MCP hosts to A2A v1-compatible agents.

It exposes the A2A v1 client operation surface through MCP tools and routes A2A calls through the official @a2a-js/sdk client.

Install From npm

Install it from the official npm registry:

npm install -g @cognicellai/a2a-mcp

Or run it directly with npx:

A2A_MCP_CONFIG=/absolute/path/to/a2a-mcp.config.yaml npx -y @cognicellai/a2a-mcp

For MCP host setup, see docs/host-setup.md. For end-to-end usage examples covering no-auth, API-key, and machine-to-machine OAuth A2A agents, see docs/user-guide.md.

The installed CLI command is a2a-mcp.

For maintainers preparing a release, see docs/release.md.

Related MCP server: vscode-a2a

Development From Source

npm install
npm run build
npm test
npm run typecheck
npm run lint:docs

Start the MCP server over stdio:

A2A_MCP_CONFIG=./a2a-mcp.config.example.yaml npm run dev

Configuration

Agents are configured by alias. Credentials are referenced by profile and resolved from the local environment; token values are never accepted as MCP tool arguments.

See a2a-mcp.config.example.yaml.

Agent Card signature handling is fail-closed by default: unsigned cards are accepted with signaturePolicy: "ifPresent", but signed cards are rejected until trust-root-backed signature verification is implemented. Use signaturePolicy: "disabled" only for explicitly trusted local or development agents.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Bridges Agent2Agent (A2A) remote agents to MCP clients by projecting each agent skill as a namespaced MCP tool. Enables stateless, task-oriented invocation of A2A agents through the MCP Tasks extension.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to interact with A2A agents through four ordinary tools, translating agent discovery, messaging, task reading, and cancellation between the A2A and MCP protocols, with support for the tasks extension.
      43 npm
      2
      Apache 2.0