ariari MCP server

A Model Context Protocol server that lets Claude query the ariari developer platform on your behalf. Check balances, look up live pricing, list available API operations, and generate runnable code samples in curl / TypeScript / C# / Kotlin / Python — all from inside a Claude conversation.

What it does

Nine tools wired to the ariari APIM gateway. All except configure_api_key and clear_api_key are read-only.

| Tool | Purpose | | --- | --- | | get_instructions | First-time onboarding guide | | configure_api_key | Validate and store your APIM subscription key in your OS keychain | | check_auth_status | Confirm the configured key resolves a valid subscription with Balances product access (never deletes the key) | | clear_api_key | Remove the stored key — use when rotating a leaked key or signing off a shared workstation | | get_reference_rate | BCCR reference rate (CRC per USD) — BID, ASK, mid, spread | | get_market_rates | Current CRC↔USD rates from each tracked Costa Rican institution | | get_balances | Wallet balances for the authenticated partner | | get_code_sample | Runnable curl/TS/C#/Kotlin/Python snippet for any documented operation | | list_operations | Browse the documented API surface |

All tools are read-only in this release. Order placement, transfer creation, and other write operations are deliberately scoped out of the v1 MVP.

Requirements

• Node.js ≥ 20.10
• A subscription key from https://developers.ariari.com

Install

Partners participating in the Phase 0 preview: see docs/partner-install.md for the canonical step-by-step (signed-tarball flow, MCP host config snippets for Claude Desktop and Claude Code, troubleshooting matrix). Public-npm install lands at v1.0.

Install (internal — link-local from source)

# From a checkout of the source repo:
cd app/ari-mcp
npm install
npm run build

# Then in your MCP host's config (e.g. ~/.claude.json):
{
  "mcpServers": {
    "ariari": {
      "command": "node",
      "args": ["/absolute/path/to/app/ari-mcp/dist/server.js"]
    }
  }
}

Authentication

The plugin stores your APIM subscription key in your OS keychain (Keychain on macOS, Credential Manager on Windows, Secret Service on Linux). The first time you use any authenticated tool, run configure_api_key and the plugin will validate the key against the platform before persisting. Invalid keys are rejected without overwriting any existing credential.

If the keychain is unavailable (headless containers, missing libsecret), the plugin falls back to a mode-0600 file at the OS-conventional config directory and warns to stderr at startup.

Privacy & data flow

Tool invocations make HTTPS requests to https://developers.ariari.com and to the ariari APIM gateway. No telemetry is sent to the plugin author. A correlation id (UUIDv4) accompanies every request and is included in any error result so support can trace a failed call.

License

UNLICENSED — internal preview. License will switch to MIT before public-npm release.

Status

This is an early read-only preview. See CHANGELOG.md for release history once 0.1 ships.