English Français العربية

io.github.jacobsd32-cpu/djd-agent-score

Official registry Finance and payments

Reputation scoring for AI agent wallets on Base. Trust scores, fraud checks, x402.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package djd-agent-score-mcp
Claude Code 
claude mcp add djd-agent-score -e 'DJD_BASE_URL=<DJD_BASE_URL>' -e 'DJD_TIMEOUT_MS=<DJD_TIMEOUT_MS>' -- npx -y djd-agent-score-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "djd-agent-score": {
            "command": "npx",
            "args": [
                "-y",
                "djd-agent-score-mcp@1.0.1"
            ],
            "env": {
                "DJD_BASE_URL": "<DJD_BASE_URL>",
                "DJD_TIMEOUT_MS": "<DJD_TIMEOUT_MS>"
            }
        }
    }
}

Environment variables

  • DJD_BASE_URL Base URL for the DJD Agent Score API (defaults to production)
  • DJD_TIMEOUT_MS Request timeout in milliseconds (default: 10000)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. djd-agent-score-mcp
  2. Tools
  3. Installation
  4. Configuration
  5. Environment Variables
  6. Development
  7. x402 Payment
  8. License

djd-agent-score-mcp

MCP server for DJD Agent Score — a reputation scoring API for AI agent wallets on Base.

This server exposes the DJD Agent Score REST API as Model Context Protocol tools, so any MCP-compatible agent (Claude, GPT, Gemini, LangChain, etc.) can call scoring endpoints natively.

Tools

ToolEndpointCostDescription
score_basicGET /v1/score/basicFreeBasic score, tier, confidence
score_fullGET /v1/score/full$0.10 (x402)Full dimension breakdown
score_refreshGET /v1/score/refresh$0.25 (x402)Re-score with latest chain data
report_fraudPOST /v1/report$0.02 (x402)Submit fraud report
check_blacklistGET /v1/data/fraud/blacklist$0.05 (x402)Check fraud reports
get_badgeGET /v1/badge/{wallet}.svgFreeEmbeddable SVG badge
get_leaderboardGET /v1/leaderboardFreeTop scored wallets
register_agentPOST /v1/agent/registerFreeRegister wallet with metadata
health_checkGET /healthFreeSystem status

Installation

npm install -g djd-agent-score-mcp

Or run directly with npx:

npx djd-agent-score-mcp

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "djd-agent-score": {
      "command": "npx",
      "args": ["-y", "djd-agent-score-mcp"]
    }
  }
}
Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "djd-agent-score": {
      "command": "npx",
      "args": ["-y", "djd-agent-score-mcp"]
    }
  }
}
Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "djd-agent-score": {
      "command": "npx",
      "args": ["-y", "djd-agent-score-mcp"]
    }
  }
}
Generic MCP Client (Streamable HTTP)

Start the server in HTTP mode:

TRANSPORT=http PORT=3000 npx djd-agent-score-mcp

Then connect your MCP client to http://localhost:3000/mcp.

Environment Variables

VariableDefaultDescription
DJD_BASE_URLhttps://djd-agent-score.fly.devAPI base URL (use http://localhost:3001 for local dev)
DJD_TIMEOUT_MS10000Request timeout in milliseconds
TRANSPORTstdioTransport mode: stdio or http
PORT3000HTTP server port (only used when TRANSPORT=http)

Development

git clone <repo-url>
cd djd-agent-score-mcp
npm install
npm run build
npm start

To point at a local API during development:

DJD_BASE_URL=http://localhost:3001 npm start

x402 Payment

Some endpoints require x402 micropayments. When an agent calls a paid tool, the API responds with HTTP 402 and payment instructions. Your agent framework must:

  1. Detect the 402 response
  2. Complete the x402 payment (USDC on Base)
  3. Retry the request with the payment proof

The MCP server surfaces the 402 details in the tool's error response so the agent can handle it.

License

MIT

Frequently asked questions

What is io.github.jacobsd32-cpu/djd-agent-score?

Reputation scoring for AI agent wallets on Base. Trust scores, fraud checks, x402.

How do I install io.github.jacobsd32-cpu/djd-agent-score?

It runs on your machine. In Claude Code: claude mcp add djd-agent-score -e 'DJD_BASE_URL=<DJD_BASE_URL>' -e 'DJD_TIMEOUT_MS=<DJD_TIMEOUT_MS>' -- npx -y djd-agent-score-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.jacobsd32-cpu/djd-agent-score need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.jacobsd32-cpu/djd-agent-score open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.jacobsd32-cpu/djd-agent-score?

It is published by jacobsd32-cpu. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.