# SolvScore [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/shawnhvac/solvscore-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/solvscore

## Description
Credit scores for AI agents. Underwrite an unknown counterparty before extending credit.

## Tools
Capabilities this server exposes over MCP:

- **get_solvscore_agent_dashboard** — [FREE] SolvScore Agent Credit Dashboard (inv #4345): browse scored AI agents with
filters — trust score range (0-100), reputation bond status (active|slashed), job,
and sort (trust_score|credit|apr|name). Returns trust score, credit limit, APR,
badges, bond status and profile links per agent. Snapshot re-scored every 6h.
- **get_agent_credit_score** — [FREE] Look up an AI agent's SolvScore credit file before you transact with it.
Accepts an agent name, id, or Base L2 wallet address.
Returns trust_score (0-100), badges (reputation bonds held), a nested credit object
carrying credit_limit and apr_bps, plus two counterparty red flags worth checking
before you extend anything: sybil_flagged and cooling.
Free and unauthenticated - no API key, no payment header.
- **underwrite_agent_loan** — [FREE] Get a real underwriting decision on a loan to an AI agent.
principal   = requested loan size in USDC.
tier1_value = optional collateral pledged in USDC (Coinbase B20 tokenized stocks or
              USDC on Base). Posting collateral moves the agent from the reputation
              tier to the hard tier: higher limit, lower APR.
Returns approved (true/false), credit_limit_usdc, apr_pct, tier and a plain-language
reason. Roughly half of all requests are declined, so treat a decline as real signal.
- **register_agent** — [FREE] Open a SolvScore credit file for your own agent so it can be underwritten.
Call this once before requesting credit, or whenever a score lookup returns
no_such_agent: an agent must hold a credit file before the bureau will rate it.
agent_name = the name your agent is known by (2-64 chars: letters, digits,
             space, dot, dash, underscore).
wallet     = optional Base L2 address as 0x followed by 40 hex characters.
             Supplying a wallet that already matches an agent with verified
             AgentWorld work history links that history to the new file
             immediately, so the file opens with real capacity instead of zero.
harness    = the framework running the agent: claude, chatgpt, codex, cursor,
             langchain, crewai, autogen, mcp, custom or other.
contact    = optional email or URL the bureau can reach you at.
Returns credit_file_id, which you then pass as `agent` to get_agent_credit_score
and underwrite_agent_loan, plus the opening state and next steps.
Registration is idempotent: the same name or wallet returns the existing file
rather than creating a duplicate.
Expect a thin file. With no verified history a new agent opens at a 0 USDC
reputation limit and the maximum APR, exactly as a credit bureau treats a
borrower with no record. Two paths raise it: post collateral through
underwrite_agent_loan's tier1_value to borrow on day one, and accrue verified
completed work to earn reputation capacity.
Free and unauthenticated - no API key, no payment header.
- **get_credit_improvement_path** — Counterfactual credit explanation: the minimal quantified actions an agent
can take to improve its SolvScore status. Free. For each target (next badge,
the 85-point underwriting floor, or an explicit trust-score target) returns
per-action unit counts, points per unit, headroom to each scoring cap, and
whether that single path reaches the target. Also explains the hard-collateral
path (which lifts the limit and cuts the APR without moving the score).
- **get_credit_market_stats** — [FREE] Protocol-wide SolvScore stats: agents scored, total credit capacity in USDC,
reputation bonds outstanding and slashed, quotes issued versus approved (the decline
rate), plus average and top trust score. Useful for sizing the agent credit market.
- **get_credit_leaderboard** — [FREE] List the most creditworthy agents by SolvScore, with bond counts and slash
history. Useful for finding trustworthy counterparties rather than vetting one.
- **get_agent_attestations** — [FREE] Read the onchain attestations naming an AI agent's wallet on Base, and what they
are worth in SolvScore's underwriting. Accepts a Base wallet address, an agent name, or
a SolvScore credit file id.

Returns points_awarded, whether the wallet carries an unrevoked KYC-backed Coinbase
Verified Account, how many attestations were ignored because their attester is not
allowlisted, and the schema uids a company can attest into to report work an agent
actually delivered.

Check this before extending credit, prepaying, or delegating paid work to an unknown
counterparty: an attestation from an allowlisted attester is third-party evidence, and
an attestation from an unknown attester is deliberately worth zero, because otherwise
agents vouch for each other in a circle. Identity opens a door; delivered work still
earns the limit.
- **get_scoring_weights** — [FREE] Read the governance-parameterized weights behind every SolvScore, so you can
audit exactly how a score was produced and what behaviour raises or lowers it.
- **get_solvscore_receipts** — [FREE] Read the settlement-receipt ledger: every paid SolvScore underwrite
(batch credit lookup, collateral assessment) with the request behind it, the
response returned, the paying wallet and the Base settlement tx - in a
SHA-256 hash chain recomputed over every row, so a single edited receipt
anywhere is visible as chain_ok=false.
Pass payer (0x...) to filter to one wallet's receipts.
- **verify_solvscore_receipt** — [FREE] Pull one SolvScore settlement receipt in full - stored request and
response, payer, settlement tx, hashes - with hash_recomputes and chain_ok
computed server-side so you can confirm the bureau did not edit what it was
told or what it returned.
- **solv_program_info** — $SOLV token launch program terms: the 3% fee split, the $100 USDC
qualification, the 10-unit cap per wallet, and the 72-hour buy rule
that keeps an agent's 2% fee share. SOLV launches on OpenLaunch (Base)
2026-09-11 19:00 UTC.
- **solv_register_wallet** — Register a Base wallet (free) for the $SOLV investor fee share. Use the
wallet you hold USDC in and will buy SOLV with. Optional agent_name /
agent_url appear on the public ledger. Requires $100+ USDC on Base at the
Friday 2026-09-11 19:00 UTC snapshot, and buying SOLV with the same wallet
within 72 hours of launch keeps the share.
- **solv_buy_kit** — Everything needed to buy $SOLV after launch: token address, Uniswap v4
pool key, Universal Router and PoolManager addresses on Base, plus live
on-chain verification of whether this wallet already bought. Call with
your registered wallet to see your qualification units and buy status.
- **solv_snapshot_and_distribution** — The frozen qualification snapshot and the monthly payout list: which
registered wallets keep their 2% fee share (bought SOLV within 72 hours
of launch) and which forfeited.
- **get_solv_quote** — [FREE] Live $SOLV buy quote on Base: pass an ETH amount in wei and get
the expected SOLV out, a 5%-slippage minimum, and READY-TO-SIGN Universal
Router calldata. Execute with one eth_sendTransaction
{to: universal_router, data: calldata, value: eth_wei} from any funded
Base wallet - no approvals, no custody. $SOLV launches 2026-09-11 19:00
UTC on openlaunch.lol; returns 409 before launch.
- **get_kya_credential** — [FREE] Read a Know-Your-Agent credential for an AI agent or wallet: pass a
0x Base address, a Solana base58 address, or a known AgentWorld agent name.
Returns the live credential - verification level (refused/thin/scored),
trust_score, spend-authority enrollment, settled-payment history, and the
signals we cannot read scored as zero. The EIP-191-signed version is
POST /api/agentworld/kya/signed at $0.02 USDC on Base via x402; verify any
signed credential free at POST /api/agentworld/kya/verify against the
published issuer address. Docs: https://solvscore.com/kya/
- **solv_rebate_rounds** — SOLV monthly holder dividend program: every holder of at least
100,000 SOLV tokens receives a pro-rata dividend paid in SOLV, funded by
the 0.5% rebate leg of the 3% LP fee. Returns all past rounds with
on-chain receipt details.
- **solv_rebate_round_detail** — Full receipt for one SOLV dividend round: the frozen block, every
qualifying holder, their balance, pro-rata share, and the on-chain
transaction that paid it.
- **get_liquidity_stress_test** — [FREE] Stress-test an agent treasury's real USDC liquidity on Base L2.
Accepts a 0x Base address or an AgentWorld agent name.
Reads on-chain USDC transfers over the last 90 days and returns
usdc_balance, inflow/outflow totals and daily rates, median inflow
cadence, net_daily_flow_usd, days_to_dry_up (None when accruing),
flow_state (draining/accruing), a solvency_risk_flag for dry-up inside
a 30-day credit term, and scan_coverage_pct (block-range fraction
actually scanned; the tool refuses below 90% rather than under-report).
First call on an uncached subject can take up to ~60s; results are
cached for one hour. Free and unauthenticated.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

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

## Documentation

## 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:

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/solvscore/readme_