# io.github.christianscode1994/volatiai

> Signed signals from 425 sectors. Every output carries an Ed25519 attestation verifiable offline.

- name: io.github.christianscode1994/volatiai
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 75/100 flags: no-repository
- quality: 75/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.christianscode1994%2Fvolatiai
- tools: https://api.protogrid.dev/v1/servers/io.github.christianscode1994%2Fvolatiai/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "volatiai": {
      "type": "http",
      "url": "https://volatiai-mcp.fourieranalys.workers.dev/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 96
- freshness: 100
- provenance: 35
- drivers: +reachable +uptime-91% +updated-3d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 75/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 75 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: purchase (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_token_balance (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_wallet_nonce (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,009 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`, `stability.new_links`: tool history recorded for 2 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 13, about 1,009 tokens to load them all
- tool set hash: ad7442a0c2741dcbbdcfa610b5de8eec
- tools last changed: 2026-11-14T02:27:36.846Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.christianscode1994/volatiai.svg)](https://protogrid.dev/servers/io.github.christianscode1994/volatiai)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-14 `get_snapshot` removed
  - Fetch a historical snapshot by date (YYYY-MM-DD). Returns signed snapshot, hash, and publication metadata. Use verify_snapshot to cryptographically verify integrity.
- 2026-11-14 `get_trust_manifest` removed
  - One-call discovery: returns all URLs, algorithms, tools, and the 4-step verification chain a consumer needs to independently verify VolatiAI data. No snapshot fetch. Use first to learn where everything lives.
- 2026-11-14 `get_current_revision` removed
  - Return the single canonical 'what is current' pointer: snapshot date, hash, signed_at, pubkey_id, and previous revision. Use this before querying a specific snapshot date to know what's freshest.
- 2026-11-14 `verify_snapshot` removed
  - Verify a VolatiAI snapshot's chain integrity and return its signature fields for independent verification. Use this to prove the data hasn't been tampered with.
- 2026-11-14 `list_categories` removed
  - List signal categories with counts.
- 2026-11-14 `resolve_entity` removed
  - Resolve a slug, alias, or entity ID to a canonical VolatiAI entity. Returns the entity metadata, all sectors it appears in, external ID mappings (CoinGecko, Wikidata), and evidence links from the entity registry. Warnings flag metric incomparability (e.g. btc-exchange-spread and eth-exchange-spread share metric "spread_pct" but measure different assets — do NOT compare their values).
- 2026-11-14 `get_anchor` removed
  - Return anchor-log status for a snapshot date: was an anchor entry recorded, what was the file SHA-256 at anchor time vs now, is a FreeTSA .tsr present. Detects post-hoc rewrites that signature verification alone cannot.
- 2026-11-14 `get_diff` removed
  - Compare two snapshots. Returns regressions (worked yesterday, broken today), recoveries (broken yesterday, working today), new sectors, and disappeared sectors. Default: compares current day to previous day.
- 2026-11-14 `find_corroborations` removed
  - Find groups of active signals measuring the same metric (e.g. BTC price from multiple exchanges). High disagreement_pct (>1%) suggests arbitrage or a data-source discrepancy.
- 2026-11-14 `get_sector` removed
  - Get current data for one sector. Sector slugs from list_active_signals output.

Full history: https://api.protogrid.dev/v1/servers/io.github.christianscode1994%2Fvolatiai/changes

## Remotes

- https://volatiai-mcp.fourieranalys.workers.dev/mcp (streamable-http, auth none, reachable true, uptime30d 0.90909094)

## Packages

_none_

## Tools (13)

- `explain_pricing`: Free. Returns full tool catalog with prices, network details (asset, payTo), and how to pay. Use before making any payment.
- `get_block_number`: Latest Base mainnet block number.
- `get_eth_balance`: Get ETH balance for a Base mainnet address. Returns balance_wei (string) and balance_eth (formatted).
- `get_gas_price`: Current Base mainnet gas price in Gwei.
- `get_token_balance`: Get ERC-20 token balance on Base. decimals_assumed=6 (USDC-style). Use balance_raw for exact integer.
- `get_wallet_nonce`: Transaction count (nonce) for a wallet address on Base mainnet.
- `get_wallet_summary`: Composite read: returns ETH balance, USDC balance, nonce, latest block, and gas price for any wallet in ONE call (5 RPC reads executed in parallel). Replaces 5 separate tool calls — 5x faster, 5x cheaper than calling individual tools.
- `list_active_signals`: Top-volatility crypto assets ranked by 1h/24h/7d change. Returns up to 10 assets.
- `page_to_markdown`: Fetch any URL and return clean Markdown. Strips scripts, styles, and HTML tags; preserves headings, links, bold/italic, lists. Useful for reading docs, news, or competitor pages into an LLM context. Deterministic and stateless — no LLM, no API key. 15s timeout, 50KB default output cap.
- `purchase`: Execute a paid tool by providing a valid x402 payment header. Returns the tool result and a signed receipt with transaction hash. Use this to purchase any paid tool in one atomic call.
- `signals_delta`: Delta feed: returns assets changed after a caller-supplied Unix timestamp. Caller holds the cursor; server is stateless. Advance `since` from `next_cursor`.
- `signals_evaluate`: Pure-function alert evaluator. Caller passes snapshot + thresholds; returns {alert, matched, reason}. Same inputs -> same outputs. policy_version=evaluate-v1.
- `signals_rank`: Deterministic ranking with published formula. risk_adjusted: abs(7d)/max(volatility,0.01). momentum: 0.5*1h+0.3*24h+0.2*7d. formula_version=rank-v1.