Ari Mcp Py
by Antmanbuildscommunityv0.1.3
39
3
ARI is an MCP server that provides live fair-market-value checks for API/service prices and offline verification of Ed25519-signed receipts for x402/MPP transactions. It also exposes service lookup, leaderboards, recent observations, and alert subscription tools for the ARI pricing index.
From the registry: Python MCP server: fair-price checks, leaderboards, Ed25519 receipt verification for x402/MPP.
Install & configure
Prerequisites
- requiredInstall Node.jsRequired for the recommended npx-based install path. The package supports Node 18+.https://nodejs.org/
- optionalAlternative Python runtimeFor Python-native hosts, install uv/uvx and use the PyPI package instead. The package supports Python 3.10+. This is an alternative to the recommended Node path, not an additional requirement.https://pypi.org/project/ari-mcp-py/
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `ari-mcp-py` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js** — Required for the recommended npx-based install path. The package supports Node 18+. (https://nodejs.org/)
Optional prerequisites:
- Alternative Python runtime — For Python-native hosts, install uv/uvx and use the PyPI package instead. The package supports Python 3.10+. This is an alternative to the recommended Node path, not an additional requirement. (https://pypi.org/project/ari-mcp-py/)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","ari-mcp"]
- optional environment variables:
- `ARI_API_BASE_URL`: Override the default public ARI API base URL to point at a private mirror. (example: `<your-ari-api-base-url>`)
Note: The README also provides a Python-native alternative for stdio hosts: command 'uvx' with args ['ari-mcp-py']. No environment variables are required for default operation.
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: The README also provides a Python-native alternative for stdio hosts: command 'uvx' with args ['ari-mcp-py']. No environment variables are required for default operation.
Tools (11)
is_fair_price
Green/amber/red verdict for a quoted price against the live FMV band.
refuse_if_overpriced
Convenience wrapper to check a price before paying and return an ok/reason result.
prepay_verdict
Full pre-pay decision with FMV band, deviation, and a citable receipt id.
get_fmv
Returns the median fair-market value plus low/high band and sample size for a service.
get_service
Returns full service details including sources, related services, and last observation.
list_services
Lists or filters services 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 base URL to point at a private mirror.Prerequisites
- • Node 18+
- • Python 3.10+
Packages
ari-mcp-py
pypiv0.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-py