Ari Mcp
by Antmanbuildscommunityv0.1.3
39
3
An MCP server that provides live fair-market-value price checks for x402/MPP services, along with service listings, leaderboards, recent observations, and signed receipt verification. It can also fetch signed receipts and set up price alerts.
From the registry: Fair-price checks, leaderboards, and Ed25519 receipt verification for x402/MPP services.
Install & configure
Prerequisites
- requiredInstall Node.jsNode.js 18+ is required to run the recommended npm package via npx.https://nodejs.org/
- optionalAlternative: install uv for Python-native hostsIf using the Python package instead of the recommended Node package, install uv and use uvx with the ari-mcp-py package. Python 3.10+ is required by the package.https://docs.astral.sh/uv/
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `ari-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js** — Node.js 18+ is required to run the recommended npm package via npx. (https://nodejs.org/)
Optional prerequisites:
- Alternative: install uv for Python-native hosts — If using the Python package instead of the recommended Node package, install uv and use uvx with the ari-mcp-py package. Python 3.10+ is required by the package. (https://docs.astral.sh/uv/)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","ari-mcp"]
- optional environment variables:
- `ARI_API_BASE_URL`: Optional base URL for the ARI API. Defaults to the public ARI API; set this only to point at a private mirror. (example: `<your-ari-api-base-url>`)
Note: Recommended portable install path is the Node package via npx. The README also provides a Python-native alternative for compatible hosts: command `uvx`, args `["ari-mcp-py"]`. The server uses stdio transport and does not require any API key by default.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Recommended portable install path is the Node package via npx. The README also provides a Python-native alternative for compatible hosts: command `uvx`, args `["ari-mcp-py"]`. The server uses stdio transport and does not require any API key by default.
Tools (11)
is_fair_price
Returns a green/amber/red verdict for a quoted price against the live fair-market-value band.
refuse_if_overpriced
Convenience wrapper that returns whether to refuse paying an overpriced quote.
prepay_verdict
Provides a full pre-pay decision with fair-market-value band, deviation, and a receipt id.
get_fmv
Returns the median fair-market value plus low/high band and sample size for a service.
get_service
Returns full details for a service, including sources, related services, and last observation.
list_services
Lists or filters the service index by protocol or category.
get_leaderboard
Returns cheapest, most expensive, and biggest movers in a category.
recent_observations
Returns raw observed price history for a service.
verify_receipt
Re-verifies a previously issued receipt id offline.
get_signed_receipt
Re-fetches the signed body for a receipt id.
subscribe_alert
Sets up a webhook or email price alert for a service.
Environment variables
ARI_API_BASE_URLOverrides the default public ARI API to point the server at a private mirror.Prerequisites
- • Node 18+
- • Python 3.10+
Packages
ari-mcp
npmv0.1.3transport: stdio
Details
- Language
- TypeScript
- License
- Apache-2.0
- Released
- May 21, 2026
- Last commit
- May 26, 2026
- Registry name
- io.github.Antmanbuilds/ari-mcp