API Reference

Get started in 3 steps.

Sign up, get your API key, connect via MCP. Your AI agent gets 203 precision math methods — exact arithmetic, no floating point, no hallucination. Works with Claude, ChatGPT, Cursor, Windsurf, and any MCP client.

Easiest connection: If you're using Claude or ChatGPT, go to Settings → Connectors (or Apps) → add https://arithym.xyz/mcp as a remote MCP server. You'll be prompted to authorize with your email — no API key needed, no config files. OAuth handles everything automatically.

1 Create your account

Pick a tier on the pricing page, enter your email, and accept the Terms of Service. You'll receive your API key — a string starting with mc_free_, mc_pro_, or mc_eng_.

Your API key is shown once. Save it immediately. We store only the hash — we cannot recover it for you.

2 Connect your MCP client

Claude Desktop — Edit claude_desktop_config.json:

{
  "mcpServers": {
    "arithym": {
      "url": "https://arithym.xyz/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with the key from Step 1. Restart Claude Desktop.

Tip: When Claude first uses an Arithym tool, your client may ask for permission. In Claude Desktop, click the Arithym server name in the MCP panel and select "Allow always" so you aren't prompted on every calculation. Other clients like Cursor have similar settings under their MCP server configuration.

ChatGPT — Go to Settings → Connectors (or Apps) → Add custom connector:

# Server URL
https://arithym.xyz/mcp

# Authentication
OAuth (automatic via authorize page)

Cursor / Windsurf / Other MCP clients — Add as a remote server:

# Server URL
https://arithym.xyz/mcp

# Transport
SSE

# Header
Authorization: Bearer YOUR_API_KEY
Arithym uses SSE (Server-Sent Events) transport. Most MCP clients support this natively. If your client supports Streamable HTTP, use https://arithym.xyz/mcp instead.

3 Start computing

Once connected, your agent has 62 tools across 22 domains. Try these to confirm your connection works:

Exact arithmetic
compute("12847", "93", "multiply")
→ 1,194,771 (exact)
Factorization
factorize("48620")
→ 2² × 5 × 11 × 13 × 17
Fractions
fraction_math("0.1", "0.2", "add")
→ 0.3 (not 0.30000000000000004)
Multi-step chain
scratch_math([["multiply","99.95","1.0825"], ["multiply","$prev","3"]])
→ 324.587625 (exact through chain)

Key tools

Arithym has 62 tools. You don't need to memorize them — your agent can call help() for a system overview, help("tool_name") for any tool's full guide, discover("keyword") to search all 203 methods, or recommend("describe your problem") to get the optimal tool suggestion.

Navigationhelp, domain_check, discover, recommend, guide_call

Arithmeticcompute, factorize, fraction_math, exact_sqrt, rational_sqrt, exact_trig

Multi-stepscratch_math, scratch_math_units, slide

Workspacefield_create, field_add, field_read, field_derive, field_update, field_sensitivity_all, field_optimize

Compute graphsgraph_define, graph_forward, graph_sensitivity, graph_solve, graph_what_if, graph_learn

Calculusgraph_derivative, graph_gradient, graph_jacobian, graph_hessian, graph_taylor, graph_integral, graph_critical_points

Unitsunit_factor, unit_check, list_units

22 domain modules via guide_call — arithmetic, fractions, roots, trig, matrix, statistics, calculus, chemistry, physics, finance, geometry, signals, complex, number theory, algebra, medical, materials, quantum, scientific, verification, units, sphere-spiral


Rate limits

Usage is tracked per API key. Both MCP and REST endpoints share the same daily counter.

Tier
Daily limit
Price
Explorer
50 computations / day
Free
Pro
500 computations / day
$5/mo
Engineer
2,000 computations / day
$20/mo
Enterprise
Custom

Limits reset at midnight UTC. If you hit your limit, the server returns a 429 status. Upgrade anytime on the pricing page.


Authentication

All requests require a Bearer token in the Authorization header. This is your API key from Step 1.

# HTTP header (set in your MCP client config)
Authorization: Bearer mc_free_aBcDeFgH...

Invalid or missing keys receive a 401 Unauthorized response. Deactivated keys receive 403. Rate-limited keys receive 429 with a Retry-After header.


Support

Questions, bugs, or feature requests — email jacob@arithym.xyz.

For detailed tool documentation once connected, call help("tool_name") from your agent. Every tool has a built-in usage guide with examples, parameter descriptions, and routing advice.