Ari MCP server

Read from the package source without running it. The installed server may list more.

• get_fmv

  Look up the current FMV (median + low/high band) for an indexed service. Use this when you need the price you'd quote a counterparty before knowing their ask.

• get_leaderboard

  Return the top services for one of the canonical leaderboards: cheapest, most_expensive, most_volatile, biggest_drop, biggest_jump, most_observed.

• get_service

  Return the full detail row for one service: slug, name, vendor, protocol, category, units, fair price, sources, related services.

• get_signed_receipt

  Look up the canonical signed body for a previously-issued receipt id, so an agent can show the exact bytes it relied on when making a payment decision.

• is_fair_price

  Compare a quoted price for a known service against ARI's current fair-market value (FMV) band. Returns a verdict (green/amber/red), the FMV, the band, the percentile, the sample size, and a citable signed receipt id.

• list_services

  Browse the ARI service index. Filter by protocol (`x402`, `mpp`), category, or free-text search. Returns paginated rows with slug, name, vendor, protocol, category, FMV, and last-observed-at.

• prepay_verdict

  The Universal Fairness Skill entry point. Wraps any agent wallet (Coinbase Agentic Wallet, AgentCash, ATXP, 1Pay.ing, …) with a refuse-to-overpay safety check. Call BEFORE settling any HTTP 402 / x402 / MPP quote. Pass the target URL (or service slug), the quoted amount in micros, the currency (default USD), and the chain (default off-chain). Returns `{ verdict: 'fair' | 'stretched' | 'overpriced'

• recent_observations

  Return the most recent price observations for one service, oldest-newest by `observedAt`. Useful when an agent wants to spot intraday trends or audit the inputs to FMV.

• refuse_if_overpriced

  Convenience wrapper agents call right before paying. Returns `should_pay: false` (with a reason and savings estimate) when the quoted amount is materially above ARI's high band; `should_pay: true` otherwise.

• subscribe_alert

  Set up a price alert. Pass a webhook URL OR an email. Conditions: `above`, `below`, or `volatility_pct` with a numeric threshold (USD or %). Proxies the existing /api/v1/alerts endpoint.

• verify_receipt

  Re-fetch a receipt by its ULID and re-verify the Ed25519 signature. Use to audit a counterparty's claim, e.g. 'I refused this payment because ARI Receipt 01HZ… said it was overpriced'.

• Code scan29 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancerepository not readable: repo not found3/15
• Maintainer identityno repository or website to verify2/10

Ari: common questions

Is Ari MCP server safe?

With care: it is graded C, so read the findings first (65/100). Read the Ari safety report

How do I install Ari?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Ari need an API key?

No secret keys are declared. It reads 1 setting from the environment.

Is Ari maintained?

The latest release is v0.1.3.