# Bichev/agentradar-mcp [Health: Active]

**Category:** 🔒 Security  
**Repository:** https://github.com/Bichev/agentradar-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 264  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bichev-agentradar-mcp

## Description
On-chain trust oracle for the ERC-8004 + x402 agent economy. 18 tools for verifying AI agents: 6-signal composite trust scoring (0-100), 272-wallet scam database, ERC-8004 identity lookup, EAS attestations on Base mainnet. x402-payable. Free getscore / checkscam. Live at vvpro.ai · npm @agentradar/mcp.

## Tools
Capabilities this server exposes over MCP:

- **verify_agent** — Run a full 6-signal trust verification on an AI agent or wallet address. Returns composite trust score (0-100), individual signal scores, risk flags, and recommendations. Use this before transacting with or delegating to an unknown agent.
- **compare_agents** — Compare two AI agents side-by-side on trust scores and security signals. Useful for choosing between competing agents that offer similar capabilities.
- **batch_verify** — Verify multiple AI agent addresses in a single call (max 10). Returns trust scores for each address. Efficient for evaluating a list of candidate agents.
- **get_score** — Get a cached trust score for an AI agent address. Faster than full verification — returns the last computed score without re-running signals. Free endpoint, no payment required.
- **get_badge_url** — Generate a trust badge URL for an AI agent. Returns an embeddable SVG badge showing the agent's trust score. Useful for displaying trust status in UIs or documentation.
- **attest_agent** — Score an AI agent and write an on-chain EAS attestation recording the trust score permanently. Costs $5 via x402 or requires an operator key. Use when you need a verifiable, immutable trust record for an agent.
- **get_attestations** — List all on-chain trust attestations written by AgentRadar. Returns paginated attestation records including addresses, scores, and transaction hashes. Requires operator key.
- **get_attestation_by_tx** — Look up a specific attestation by its transaction hash. Returns the full attestation record including the scored address, trust score, and on-chain details.
- **lookup_identity** — Look up an AI agent's on-chain identity (ERC-8004 registration, ENS name, contract metadata). Returns who the agent claims to be and whether those claims are verified.
- **lookup_reputation** — Look up an AI agent's on-chain reputation — ERC-8004 feedback history, attestation count, and community signals. Shows how established and trusted the agent is in the ecosystem.
- **resolve_agent_uri** — Resolve an agent address to its registered URI, metadata, and service endpoints. Useful for discovering how to interact with a verified agent.
- **check_scam** — Check if a wallet address is in the AgentRadar scam database. Returns matching scam records with severity, chain, source, and notes. Use this as a quick safety check before any transaction.
- **add_scam_wallet** — Report a malicious wallet address to the AgentRadar scam database. Requires operator key. Include chain, severity level, source of intel, and optional notes.
- **explain_score** — Get a human-readable explanation of an agent's trust score. Returns a narrative breakdown of each signal's contribution, risk factors, and actionable recommendations. Best for presenting trust analysis to end users.
- **get_health** — Check AgentRadar API health and connectivity status. Returns service status, uptime, and version info. Use to verify the API is reachable before making other calls.
- **get_stats** — Get AgentRadar dashboard statistics — total verifications, attestations written, scam wallets tracked, and API usage metrics. Requires operator key.
- **list_signals** — List all trust scoring signals used by AgentRadar with their weights and descriptions. Helps understand how the composite trust score is calculated.
- **get_pricing** — Get AgentRadar API pricing information. Shows costs for each endpoint including x402 micropayment amounts and free tier details.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "agentradar-mcp": {
    "command": "npx",
    "args": ["-y","@agentradar/mcp"],
    "env": {
      "AGENTRADAR_API_URL": "",
      "AGENTRADAR_OPERATOR_KEY": ""
    }
  }
}
```

**Requires environment variables:** `AGENTRADAR_API_URL`, `AGENTRADAR_OPERATOR_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Bichev/agentradar-mcp MCP server does

Bichev/agentradar-mcp MCP server connects an MCP client to the AgentRadar API at `https://api.vvpro.ai`. It is a thin client wrapper rather than an independent scoring database or blockchain indexer. The package exposes 18 tools for evaluating AI agents and wallet addresses through trust scores, identity data, reputation signals, scam records, and attestations.

The main verification flow returns a composite score from 0 to 100, the individual signal scores, risk flags, and recommendations. Other tools support side-by-side comparison, batch verification of up to 10 addresses, cached score retrieval, human-readable score explanations, and embeddable trust badge URLs.

## How it works

The server sends MCP tool requests to the public AgentRadar API. `verify_agent` runs the full six-signal assessment, while `get_score` retrieves the last computed score without rerunning the signals. `list_signals` provides the scoring signals, their weights, and descriptions, which can help an application explain how a result was formed.

Identity and ecosystem checks cover ERC-8004 registrations, ENS names, contract metadata, feedback history, attestation counts, community signals, and registered agent URIs. `check_scam` performs a focused lookup against the AgentRadar scam database, returning records such as severity, chain, source, and notes when available.

For permanent records, `attest_agent` scores an agent and writes an on-chain EAS attestation. Existing attestations can be listed or retrieved by transaction hash. These write and administrative operations have different access requirements from free lookups.

## Setup and configuration

The package can be started directly with:

```bash
npx -y @agentradar/mcp
```

It is documented for Claude Desktop and Cursor, using an MCP configuration with the `npx` command and `@agentradar/mcp` package. The same package can also be built locally after cloning the repository, installing npm dependencies, running the build, and starting `node dist/index.js`.

`AGENTRADAR_API_URL` optionally overrides the default API base URL. `AGENTRADAR_OPERATOR_KEY` enables operator-only endpoints and bypasses x402 payment where the API permits it. The operator key is not required for the basic public setup described in the repository.

## Tools and capabilities

Bichev/agentradar-mcp MCP server includes these capability groups:

- Verify one agent, compare two agents, or batch-check up to 10 addresses.
- Retrieve cached scores, explain score composition, and list scoring signals.
- Look up ERC-8004 identity, reputation, registered URI, metadata, and service endpoints.
- Check or report scam wallets.
- Create, list, and inspect on-chain EAS trust attestations.
- Check API health, retrieve dashboard statistics, and inspect pricing.
- Generate a trust badge URL for use in an interface or document.

## Limitations and notes

The package depends on the AgentRadar API and its available on-chain data. A score is composed from the service’s six signals; the repository does not describe the signals as a substitute for independent transaction review. Batch verification is limited to 10 agents per call.

`get_score` is free, while `verify_agent` is listed at $0.005 per call and `attest_agent` at $5 per attestation when paid through x402. The repository states that these calls can be free with an operator key. Administrative endpoints, including statistics and several attestation or reporting operations, require that key. The project is released under the MIT license.

_Full upstream README: https://allmcps.com/mcp/bichev-agentradar-mcp/readme_