Agent Index MCP server

by agent-idx·io.github.agent-idx/mcp·v0.4.5

No reviews yet

P2P Agent Index MCP — publish and search decentralized web indexes over libp2p.

A85/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A85/100

full report

Adoption

New

0 stars40 downloads/wk

Reviews

Write one

Nobody has reviewed Agent Index yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Agent Index tools (12, 2 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

add_keywords
Add keywords to this peer advertisement list and publish them to the DHT.
find_peers_by_keyword
Discover peers advertising a keyword and fetch their ANP locators over direct libp2p without fetching index records.
get_agent_identity
Get this peer libp2p ID and locally configured ANP locators.
get_network_setup
Start here: how this MCP server connects to the Agent Index network, where to find current routing/relay multiaddrs (Active Nodes directory), and what each explorer section means. No hardcoded peer addresses.
get_peer_profile
Fetch ANP locators and advertised keywords directly from another edge peer over libp2p.
get_peer_status
Local edge peer ID, keyword/record counts, and ANP locators. Does not list network infrastructure — use get_network_setup for routing/relay directory guidance.
publish_indexwrite action
…Publish a page summary locally and advertise agent-chosen keywords for peer discovery.
query_peer_index
Query another edge peer index directly over libp2p (hole-punch via relay when needed). Bypasses DHT discovery.
remove_keywordswrite action
Remove keywords from this peer advertisement list.
search_index
…Discover other edge peers by keywords, fetch their index records and ANP locators over direct libp2p. Empty peers usually means no publisher is online for those keywords — not that infrastructure is down. Call get_network_setup if unsure.
set_agent_identity
Set ANP locators advertised to other edge peers: WNS handle (active discovery) and/or passive Agent Description URL.
set_keywords
Replace the peer advertisement keyword list and re-publish to the DHT.

Public scan report

scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it

no findings

Code scan10 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 72 days ago12/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Agent Index compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 85/100; higher than 73% of 4,460 AI and agents servers
Tools: 12; the typical AI and agents server has 6
Tools that change things: 17%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 40; more than 32% of 1,538 AI and agents servers with a package

What its tools let an agent do: 7 read · 1 create · 2 change · 1 delete · 1 send or post

Install Agent Index in Claude Code, Cursor or VS Code

Runs npx -y @agent-idx/client on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp -- npx -y @agent-idx/client

Add to Cursor

What the publisher says

From the Agent Index repository's README, as published. We do not edit it. Read it on GitHub

@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 AGENTINDEXDIRECTORYURL in MCP server env so agents can call getnetwork_setup and receive the directory link.

{
  "mcpServers": {
    "agent-index": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-idx/client",
        "-b",
        "<routing-peer-multiaddr-from-active-nodes>",
        "-r",
        "<relay-peer-multiaddr-from-active-nodes>"
      ],
      "env": {
        "AGENT_INDEX_DIRECTORY_URL": "https://<your-web-app>/nodes"
      }
    }
  }
}

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 getnetworksetup for a machine-readable summary of how the network works.

CLI

npx -y @agent-idx/client \
  -b <routing-peer-multiaddr-from-active-nodes> \
  -r <relay-peer-multiaddr-from-active-nodes>

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

MCP tools

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.

Nothing above is checked by us. What we check is on the safety report.

Agent Index: common questions

Is Agent Index MCP server safe?: Yes, by our scan: it is graded A (85/100). Read the Agent Index safety report
How do I install Agent Index?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Agent Index need an API key?: No secret keys are declared. It reads 1 setting from the environment.
Is Agent Index maintained?: The last commit was 111 days ago (2026-07-16). The latest release is v0.4.5.
What can I use instead of Agent Index?: Servers from other publishers that do the same job: agent-device MCP server, Robin: AI-Powered Dark Web OSINT MCP server and Pm Claude Skills MCP server.
How does Agent Index compare with other AI and agents MCP servers?: safety score 85/100 (higher than 73% of 4,460 AI and agents servers); tools 12 (the typical AI and agents server has 6); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Agent Index

Same job from other publishers: the closest match first, then the best rated.

agent-device
Open source device layer for AI agents: control mobile, web, TV, and desktop apps over MCP
not reviewed
Widely used
A
Robin: AI-Powered Dark Web OSINT
Dark web OSINT over Tor: search onion engines, scrape pages, report with your own model.
not reviewed
Established
A
Pm Claude Skills
1310 professional Agent Skills + workflow recipes — searchable & fetchable over MCP.
not reviewed
Established
A
Mockserver
Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.
not reviewed
Established
A
CHAP Coordinator
Auditable records of human decisions over AI agent work. Approvals, edits, overrides, escalations.
not reviewed
Established
A