P2P Agent Index MCP — publish and search decentralized web indexes over libp2p.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Capabilities & Tool Schemas (10)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Agent Index.
get_network_setupStart here** — directory URL, configured peers, Active Nodes sections, blind-test flow
publish_indexStore a page summary and advertise agent-supplied `keywords
search_indexDiscover peers by `keywords`, fetch records for `query`, return merged JSON
query_peer_indexQuery a known peer ID directly (bypasses DHT; uses relay hole-punch when needed)
add_keywordsAdd keywords to this peer's advertised topic list
remove_keywordsRemove keywords from this peer's advertised topic list
Documentation Overview
@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.
Source: github.com/agent-idx/mcp
Agents choose keywords and judge result relevance. The client provides network plumbing only.
Install (npx)
Routing and relay peer multiaddrs change over time. Copy current values from the network Active Nodes directory (/nodes on the project website), not from docs or old configs.
Optional: set AGENT_INDEX_DIRECTORY_URL in MCP server env so agents can call get_network_setup and receive the directory link.
On the Active Nodes page:
- Routing Peers →
-b(required) - Relay Peers →
-r(recommended behind NAT / home routers) - Active Index Nodes → edge agents currently online (empty when nobody is connected; does not mean infrastructure is down)
After connecting, call MCP tool get_network_setup for a machine-readable summary of how the network works.
CLI
For NAT traversal (home routers, etc.), add -r / --relay with the public relay peer multiaddr from Active Nodes. 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 (from Active Nodes) |
-r, --relay <multiaddr> | NAT relay peer for circuit-relay + DCUtR hole-punching (from Active Nodes) |
-d, --db <path> | Local index store (default: index_store.json) |
-k, --keywords <path> | Local keyword store (default: keywords.json) |
MCP tools
| Tool | Description |
|---|---|
get_network_setup | Start here — directory URL, configured peers, Active Nodes sections, blind-test flow |
publish_index | Store a page summary and advertise agent-supplied keywords |
search_index | Discover peers by keywords, fetch records for query, return merged JSON |
query_peer_index | Query a known peer ID directly (bypasses DHT; uses relay hole-punch when needed) |
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/registry discovery only — peer IDs and multiaddrs |
get_peer_status | Local peer ID, configured routing/relay, keyword and record counts |
get_peer_profile | Fetch ANP locators from another edge peer over libp2p |
Develop from source
Publish to npm (maintainers)
Requires membership in the @agent-idx npm organization.
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
npm downloads
318
Package downloads in the last 30 days.
Last commit
2mo ago
Most recent push to the default branch.
Tools exposed
10
Callable tools this server registers over MCP.
Directory activity
1 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Agent Index
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/agent-index)HTML Embed
<a href="https://allmcps.com/mcp/agent-index"><img src="https://allmcps.com/api/badge/agent-index?style=directory" alt="Agent Index on AllMCPs" /></a>Technical Specs & Signals
CategorySearch & Data Extraction
5/8 checks healthy over the last 45d
52Quality signal: Good · 52/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools24/30
Adoption & activity5/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 5d ago via OSV.dev · @agent-idx/client (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.