English Français العربية

ListSmith

Official registry Other

MCP server for ListSmith — x402 listing grades ($0.10) and repairs ($0.50) on Base

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).

PYPI package list-smith-mcp
Claude Code 
claude mcp add listsmith -e 'AGENT_PRIVATE_KEY=<your agent_private_key>' -e 'AGENT_KEY_FILE=<AGENT_KEY_FILE>' -e 'LIST_SMITH_URL=<LIST_SMITH_URL>' -e 'LIST_SMITH_GRADE_MAX_AMOUNT_UNITS=100000' -e 'LIST_SMITH_FIX_MAX_AMOUNT_UNITS=500000' -- uvx list-smith-mcp==0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "listsmith": {
            "command": "uvx",
            "args": [
                "list-smith-mcp==0.1.2"
            ],
            "env": {
                "AGENT_PRIVATE_KEY": "<your agent_private_key>",
                "AGENT_KEY_FILE": "<AGENT_KEY_FILE>",
                "LIST_SMITH_URL": "<LIST_SMITH_URL>",
                "LIST_SMITH_GRADE_MAX_AMOUNT_UNITS": "100000",
                "LIST_SMITH_FIX_MAX_AMOUNT_UNITS": "500000"
            }
        }
    }
}

Environment variables

  • AGENT_PRIVATE_KEY secret EVM private key (0x...) of a wallet holding USDC on Base. Used locally to sign the x402 EIP-3009 authorization. For paid calls.
  • AGENT_KEY_FILE Path to a file containing that key (alternative to AGENT_PRIVATE_KEY).
  • LIST_SMITH_URL Service base URL override (default: production).
  • LIST_SMITH_GRADE_MAX_AMOUNT_UNITS Spend guard per grade call in USDC micro-units (default 100000 = $0.10, the known price). The client refuses to sign anything priced above it.
  • LIST_SMITH_FIX_MAX_AMOUNT_UNITS Spend guard per fix call in USDC micro-units (default 500000 = $0.50, the known price). The client refuses to sign anything priced above it.

Documentation

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

Token Verdict — agent distribution wrappers

Native tool wrappers for Token Verdict, the pay-per-call token risk screen for AI agents ($0.02 USDC per call on Base, via the x402 protocol).

Token Verdict's buyers are other agents. These packages put the service on the shelves agents actually shop from, in the formats they call natively — payment handled by each agent's own wallet, with a spend guard at the known price:

PackageStackWhat it gives an agent
mcp/Python · MCP (stdio)A token_verdict tool in any MCP host (Claude Desktop, Cursor, custom runtimes), paying via an operator-configured EVM signer.
agentkit/TypeScript · Coinbase AgentKitA token_verdict action in any AgentKit agent, paying from the agent's EvmWalletProvider.

Both wrap the same real contract — POST /v1/verdict:

{ "address": "0x2821d96B5FC81aEC3763340b375a846a89A3Ec1b", "chain": "base" }

→ { token, verdict: SOLID|CAUTION|DANGER, score (0–100), signals (six weighted market-structure signals), take, market }.

Both implement the standard x402 v2 exact-scheme flow (402 → sign an EIP-3009 USDC authorization → retry with PAYMENT-SIGNATURE), the same flow used for the service's live cataloging payment; the service settles through its PayAI facilitator server-side. Neither package contains or transmits any private key: keys stay in the operator's environment / wallet provider, and every test payment is mocked — the test fixtures are the real 402 challenge captured from production (2026-10-23) and the service engine's own published example verdict.

Service source: QuincyGB/token-verdict (discovery manifest at /.well-known/x402, agent docs at /skill.md).

MIT licensed.

Frequently asked questions

What is ListSmith?

MCP server for ListSmith — x402 listing grades ($0.10) and repairs ($0.50) on Base

How do I install ListSmith?

It runs on your machine. In Claude Code: claude mcp add listsmith -e 'AGENT_PRIVATE_KEY=<your agent_private_key>' -e 'AGENT_KEY_FILE=<AGENT_KEY_FILE>' -e 'LIST_SMITH_URL=<LIST_SMITH_URL>' -e 'LIST_SMITH_GRADE_MAX_AMOUNT_UNITS=100000' -e 'LIST_SMITH_FIX_MAX_AMOUNT_UNITS=500000' -- uvx list-smith-mcp==0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ListSmith need an API key?

Yes. It expects AGENT_PRIVATE_KEY, which you set in its configuration.

Is ListSmith open source?

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

Who maintains ListSmith?

It is published by QuincyGB. 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.