a2ald

npm distribution of the A2AL daemon (a2ald): decentralized agent networking for AI agents.

The main package pulls in the correct platform binary via optional dependencies (@a2al/a2ald-*). Install once; the right binary is selected for Linux, macOS, or Windows (x64/arm64 where applicable).

MCP integration

Lets AI agents find and connect to other agents directly—no central server, registry, or pre-configured endpoint required.

Add to your MCP client config (Cursor, Claude Desktop, Windsurf, Cline, etc.):

{
  "mcpServers": {
    "a2al": {
      "command": "a2ald",
      "args": ["--mcp-stdio"]
    }
  }
}

If a2ald is not on PATH, use npx -y a2ald --mcp-stdio or an absolute path to the binary. For daily use, install as a service and connect via "url": "http://127.0.0.1:2121/mcp/".

Always call a2al_status first and wait for network_ready: true before network operations.

Install guide: doc/llms-install.md · Full setup: doc/mcp-setup.md

Install

npm install a2ald

Programmatic use

const { getBinaryPath } = require("a2ald");
const bin = getBinaryPath();
// spawn or exec `bin` as your process needs

CLI

After install, the a2ald binary is available where npm links local binaries (e.g. npx a2ald or your node_modules/.bin).

npx a2ald --help

What a2ald provides

Once running, the daemon exposes a local REST API on http://127.0.0.1:2121. Key endpoints:

| Endpoint | Description | |----------|-------------| | POST /fetch/{aid} | Send an HTTP request to a remote agent over encrypted QUIC; daemon handles transport internally | | POST /connect/{aid} | One-shot tunnel: returns a local TCP address for a single session | | POST /tunnel/{aid} | Persistent multiplexed tunnel: multiple concurrent TCP connections over one QUIC pool | | POST /resolve/{aid} | Look up a remote agent's current endpoints |

A built-in MCP server exposes all capabilities as tools for AI agents. Full API reference: doc/api-reference.md

For CLI usage outside Node, see the a2al tool in the same repository (a2al get, a2al post, a2al tunnel commands).

Official websites

• a2al.org - project site and documentation
• tanglednet.org / tngld.net - Tangled Network

License

MPL-2.0