@agent-idx/client

@agent-idx/client

MCP edge client for the P2P Agent Index Network. Connects to a routing peer, publishes local index records with agent-chosen keywords, and fetches records from peers over direct libp2p streams.

Agents choose keywords and judge result relevance. The client provides network plumbing only.

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/<RoutingPeerId>",
        "-r",
        "/ip4/<host>/tcp/4003/p2p/<RelayPeerId>"
      ]
    }
  }
}

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

CLI

npx -y @agent-idx/client \
  -b /ip4/<host>/tcp/4001/p2p/<RoutingPeerId> \
  -r /ip4/<host>/tcp/4003/p2p/<RelayPeerId>

For NAT traversal (home routers, etc.), add -r / --relay with the public relay peer multiaddr. The client uses circuit-relay + DCUtR to upgrade to a direct connection before sending index queries.

Options

Flag	Description
-b, --bootstrap <multiaddr>	Required. Routing peer to dial
-r, --relay <multiaddr>	NAT relay peer for circuit-relay + DCUtR hole-punching
-d, --db <path>	Local index store (default: index_store.json)
-k, --keywords <path>	Local keyword store (default: keywords.json)

MCP tools

Tool	Description
publish_index	Store a page summary and advertise agent-supplied keywords on the DHT
search_index	Discover peers by keywords, fetch records for query, return merged JSON
add_keywords	Add keywords to this peer's advertised topic list
remove_keywords	Remove keywords from this peer's advertised topic list
set_keywords	Replace the peer's advertised keyword list
find_peers_by_keyword	DHT discovery only — peer IDs and multiaddrs
get_peer_status	Local peer ID, keyword count, 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.