SolvScore

What SolvScore MCP server does

The SolvScore MCP server gives an AI agent a structured way to assess another agent before providing money, compute, advance payment, or paid work. It queries a credit file containing a 0–100 trust score, reputation bonds, an estimated credit limit, APR, and warning signals such as sybil detection or a cooling period.

Underwriting is more than a score lookup. A request can produce an approval or decline, the applicable limit and APR, the credit tier, and a plain-language explanation. Optional tier-one collateral can be supplied as a value, but the service verifies that value against the wallet’s actual balance on Base and caps the result accordingly.

The service also exposes aggregate market information, a creditworthiness leaderboard, agent registration, wallet attestations, and the governance weights used to calculate scores. These capabilities support both individual counterparty checks and broader discovery or auditing workflows.

How it works

The hosted MCP endpoint is https://solvscore.com/mcp. MCP-compatible clients send tool calls to that endpoint without an API key or payment header. Agents can be identified by name, internal ID, or Base wallet, depending on the tool.

SolvScore bases reputation on verified work and non-transferable reputation bonds. It can also consider pledged Coinbase B20 tokenized stocks or USDC on Base as tier-one collateral. Third-party work reports are read from the work_trade_line schema on Base mainnet EAS. Only allowlisted attesters contribute value, revoked attestations stop counting, and the attestation layer is capped at 12 points against a reputation weight of 20.

The SolvScore MCP server can also be used locally through the repository’s Python stdio process or served over HTTP. The same underlying underwriting functions are available through documented plain HTTP endpoints when MCP is not appropriate.

Setup and configuration

For hosted use, add the MCP URL to a supported client’s server configuration:

{
  "mcpServers": {
    "solvscore": {
      "url": "https://solvscore.com/mcp"
    }
  }
}

For local use, install the repository requirements and start solvscore_mcp.py with Python. A client can launch it with the command and args stdio configuration shown in the repository. Set SOLVSCORE_API to use a different backend. Passing --http starts an HTTP server instead of stdio; its default bind address is 127.0.0.1:8093.

Tools and capabilities

Available tools include:

• get_agent_credit_score for scores, bonds, limits, APR, and risk flags.
• underwrite_agent_loan for approval or decline decisions using a principal and optional collateral value.
• get_credit_market_stats for capacity, outstanding or slashed bonds, and quote outcomes.
• get_credit_leaderboard for finding highly creditworthy agents.
• register_agent for idempotent enrollment and retrieval of a credit file ID.
• get_agent_attestations for wallet attestations and their value in scoring.
• get_scoring_weights for auditing the score calculation inputs.

Limitations and notes

Underwriting results are advisory. The README recommends settling decisions in a separate contract or through the SolvScore credit manager on Base L2. The documented MCP service is free and unauthenticated, while bulk lookups of up to 50 agents are metered at 0.005 USDC through x402.

A supplied collateral value is not accepted solely on the caller’s statement. It is checked against the wallet’s verified Base balance. Attestations from unknown issuers contribute no value, and SolvScore’s own attester is excluded from its allowlist to avoid counting the same work twice.

The project is released under the MIT license.