Basis Protocol

io.github.basis-protocolPublished by GitHub account basis-protocolv1.0.0Updated Oct 27, 2026

Attested risk scores for stablecoins, DeFi protocols and wallets, with receipts.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server exposing attested risk scores for stablecoins, DeFi protocols and wallets, with verifiable receipts and a Q&A agent.

What you can do
  • Look up stablecoin SII scores, grades and confidence, with optional category fields
  • Read daily score history for a coin over a lookback window
  • Fetch market, governance and risk data such as liquidity depth, yields, governance activity, bridge flows, exchange health and volatility
  • Resolve any entity by symbol, slug, contract or wallet address, operator or vault name
  • Ask the Basis Agent questions about attested risk state and verify receipt or citation hashes
  • Read the scoring methodology in summary or full form
When to use it
Useful when an assistant needs to check or compare stablecoin and DeFi risk before making or explaining decisions, or when answers must be backed by verifiable attestation hashes rather than unsourced claims.
Requirements
A remote streamable HTTP endpoint; no local package or runtime. An optional hub API key can be passed in the x-api-key header or as an apikey query parameter to attribute reads. Network access to the provider's endpoint.
Before you install
The API key is sent to the provider and attributes your reads; keep it out of shared logs. The server states it never recommends positions or forecasts, so its scores are informational risk data, not investment advice. Queries it cannot ground are refused, and unknown hashes resolve as unknown rather than erroring.

Installation

In SourceWeft

  1. Open Basis Protocol in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.basis-protocol%2Fbasis/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "basis-protocol": {
      "type": "http",
      "url": "https://basisprotocol.xyz/mcp"
    }
  }
}

README

This repository has no README.

Tools

7

get_stablecoin_scores

Current SII scores (0-100) for scored stablecoins. Use before any decision involving stablecoins. Parameters: limit: max coins returned (default 25, max 500) fields: columns to return per coin (default id, symbol, name, issuer, score, grade, confidence, stale, computed_at); name "categories" for category scores sort_by: "score_desc" (default), "score_asc", or "symbol" One coin's detail: entity_read(query).

Parameterslimitfieldssort_by

get_methodology

The Basis methodology. mode="summary" (default): index list, versions, component counts. mode="full": the complete SII formula, weights and component specifications (large).

Parametersmode

basis_data

Market, governance and risk data in one tool. Pick a kind: liquidity_depth (entity=coin id), yield_data (entity=protocol, optional), governance_activity (entity=protocol slug; window=days, 90), bridge_flows (entity=bridge id, optional), exchange_health (entity=exchange id, optional), volatility (entity=asset id), incidents (entity=entity id, optional), peg_monitor (summary of latest deviation + status per coin; detail=true with entity returns that coin's 5-minute series, window=hours, 24), venue_shift (entity=operator slug, optional), asset_footprint (entity=token or symbol), divergence (capital-flow vs quality signals; severity=notable|alert|critical, limit=20, window=hours 24), treasury_events (entity=wallet, optional), riskiest_wallets (limit=20), scoring_backlog (limit=20). Responses are capped near 12 KB; an unknown kind returns the list of kinds.

Parameterskindrequiredlimitdetailentitywindowseverity

basis_answer

Ask the Basis Agent a question about attested risk state. Answers cite attestation hashes; ungroundable queries are refused. Never recommends positions or forecasts. Pass your hub API key (x-api-key header or ?apikey=) to attribute reads. Multi-turn: pass the envelope's session_id back as session_id. Parameters: query: The question (max 4000 chars). session_id: Session UUID from a previous envelope (optional).

Parametersqueryrequiredsession_id

receipt_verify

Verify a receipt or citation hash from an envelope (basis_answer, entity_read). Resolves it against the attestation tables and returns what it attests to, or that it is unknown. ``source`` optionally restricts the table.

Parametershashrequiredsource

entity_read

Look up any entity by symbol, slug, contract/wallet address, operator or vault name. Returns {entity_type, id, score, grade, confidence, receipt_hash, links}. When nothing resolves returns {match: null, did_you_mean: [up to 5 candidates]} rather than an error.

Parametersqueryrequired

score_history

Daily SII score history for a stablecoin: a list of {date, score, grade} only. Parameters: coin: symbol, slug or contract address (resolved like entity_read) days: lookback window, 1-365 (default 30)

Parameterscoinrequireddays

Version history

1
  1. v1.0.0LatestSep 29, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.