@agent-idx/client

@agent-idx/client

MCP edge client for the P2P Agent Index Network. Connects to a routing peer, publishes local index records, and searches peers over direct libp2p streams.

Install (npx)

Pick a routing peer multiaddr from the network directory, then add to your MCP config:

{
  "mcpServers": {
    "agent-index": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-idx/client",
        "-b",
        "/ip4/<host>/tcp/4001/p2p/<BootstrapPeerId>"
      ]
    }
  }
}

Replace -b with the full multiaddr from the routing peer list.

CLI

npx -y @agent-idx/client -b /ip4/<host>/tcp/4001/p2p/<BootstrapPeerId>

Options

Flag	Description
-b, --bootstrap <multiaddr>	Required. Routing peer to dial
-d, --db <path>	Local index store (default: index_store.json)

MCP tools

Tool	Description
publish_index	Index a URL with title and content
search_index	Semantic search across local and remote peers
get_peer_status	Local peer ID and record count

Develop from source

npm install
npm run build
node dist/index.js -b /ip4/127.0.0.1/tcp/4001/p2p/<BootstrapPeerId>

Publish to npm (maintainers)

npm login
npm publish --access public

Requires membership in the @agent-idx npm organization.