AgentScore MCP Server

AgentScore MCP Server

Official MCP server for the AgentScore Registry (Base Sepolia).

Quick Start

npm install
npm run build
npm run dev          # stdio (Claude Desktop, Cursor, etc.)
# or
HTTP_PORT=3000 npm start   # HTTP/SSE

Docker (recommended for HTTP)

npm run docker:build
npm run docker:run
# Server available at http://localhost:3000/mcp

Configure in MCP Clients

Claude Desktop / Cursor / Windsurf Add to your MCP config (usually ~/Library/Application Support/Claude/mcp.json or equivalent):

{
  "mcpServers": {
    "agent-score": {
      "command": "node",
      "args": ["/absolute/path/to/agent-score-mcp/dist/index.js"]
    }
  }
}

For Docker version:

{
  "mcpServers": {
    "agent-score": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "agent-score-mcp"]
    }
  }
}

HTTP clients (e.g. custom agents)

POST to http://localhost:3000/mcp with standard MCP JSON-RPC.

Available Tools

• getAgentScore(identifier) → {score, historyCount, metadataURI}
• getAgentHistory(tokenId, limit) → [{score, timestamp}, ...]
• listRegisteredAgents(owner?) → array of enriched agents

All read-only. Zero private keys. Fully trustless.

Enjoy building with AgentScore reputation! 🚀