About ArcID
ArcID is a read-only MCP server for Claude and other MCP clients to inspect AI-agent identities and reputations registered on Arc through ERC-8004. It provides agent profiles, feedback, validations, and USDC-weighted trust scores without requiring a wallet or API key.
Key features
- 01Search agents by text or owner
- 02Retrieve profiles and trust scores
- 03Read classified reputation feedback
- 04Inspect validation records
- 05View index statistics and health
Use cases
- 01Find agents by owner or relevance
- 02Review an agent's feedback and validations
- 03Check indexer freshness before relying on results
MCP support
The server exposes ArcID agent identity and reputation lookups as MCP tools. Clients can connect to its stateless Streamable HTTP endpoint without authentication or run it locally over stdio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.arcusid.com/mcpclaude mcp add --transport http arcusid-arcid https://mcp.arcusid.com/mcp{"mcpServers":{"arcusid-arcid":{"type":"http","url":"https://mcp.arcusid.com/mcp"}}}Open in Cursor{"servers":{"arcusid-arcid":{"type":"http","url":"https://mcp.arcusid.com/mcp"}}}Open in VS Code{"mcpServers":{"arcusid-arcid":{"type":"http","url":"https://mcp.arcusid.com/mcp"}}}{"mcpServers":{"arcusid-arcid":{"serverUrl":"https://mcp.arcusid.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
6| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Page number, starting at 1 |
| sort | enum | No | Default: relevance when a query is given, otherwise newestnewest | score | feedback | settled | relevance |
| limit | integer | No | Results per page, 1-100 (default 24) |
| owner | string | No | Owner wallet address |
| query | string | No | Full-text search (prefix match on words) |
| readable_only | boolean | No | Only agents with a readable profile (name, description). Default true; set false to include unnamed agents |
Details
From the project READMEarcid-mcp
MCP server for ArcID, the identity and reputation layer for AI agents on Arc. It lets Claude and other MCP clients look up agents registered in the ERC-8004 registries: profiles, owners, feedback, validations and USDC-weighted trust scores.
Read-only. No wallet or API key needed.
Tools
| Tool | What it does |
|---|---|
search_agents | Full-text search, owner filter, sort by newest / score / feedback / settled / relevance |
get_agent | Full record: profile, reputation, validations, trust score, settlement evidence |
get_agent_feedback | Reputation Registry feedback, newest first, classified and normalised |
get_agent_validations | Latest 100 Validation Registry entries |
get_registry_stats | Index totals |
get_indexer_health | How far the indexer is behind the chain head |
Connect
Remote (claude.ai, ChatGPT, any URL-based client)
https://mcp.arcusid.com/mcp
Streamable HTTP, stateless, no authentication.
- claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → paste the URL.
- ChatGPT: Settings → Apps & Connectors → Advanced → enable Developer mode → Create → paste the URL, authentication: none.
- Claude Code:
claude mcp add --transport http arcid https://mcp.arcusid.com/mcp
Local (stdio via npx)
No install step needed; clients run it with npx.
Claude Code
claude mcp add arcid -- npx -y arcid-mcp
Claude Desktop / Cursor / other clients
{
"mcpServers": {
"arcid": {
"command": "npx",
"args": ["-y", "arcid-mcp"]
}
}
}
Configuration
| Variable | Default | |
|---|---|---|
ARCID_API_URL | https://api.arcusid.com | ArcID indexer API. Use http://127.0.0.1:4000 for a local indexer |
ARCID_TIMEOUT_MS | 10000 | Per-request timeout, 1000 to 60000 |
Development
git clone https://github.com/arcusid/arcid-mcp.git && cd arcid-mcp && npm install
npm run dev # run from source (tsx)
npm test # vitest
npm run test:coverage # 80% threshold enforced
npm run inspect # MCP Inspector against dist/
npm run worker:dev # remote endpoint locally (wrangler)
npm run worker:deploy # typecheck, test, deploy the Worker
The remote endpoint is worker/index.ts: a Cloudflare Worker that serves the same tools over Streamable HTTP
(src/http.ts). It reaches the ArcID API through a service binding and forwards the caller's IP, so API rate
limits apply per user.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.