Agent and Developer Resource

Coin IRA Calculator API

Read-only calculation tools for retirement projections and historical cryptocurrency investment results.

Discovery

MCP server

https://coinira.com/mcp

This endpoint uses stateless MCP Streamable HTTP. It supports current MCP clients and clients that use the earlier initialization flow. It does not require credentials.

The server provides calculate_historical_crypto_investment and calculate_retirement_projection. Each tool result includes structured data, a plain-language summary, Coin IRA attribution, source links, and the applicable disclosure.

{"mcpServers":{"coinira":{"url":"https://coinira.com/mcp"}}}

Retirement projection

GET /api/calculators/retirement/

Required query parameters are asset, starting_balance, monthly_contribution, years, and annual_return.

GET /api/calculators/retirement/?asset=BTC&starting_balance=10000&monthly_contribution=500&years=20&annual_return=7

This endpoint uses a constant annual return supplied by the caller. It does not use historical market data.

The response names Coin IRA as the calculation provider and includes links to the matching public calculator and this methodology.

Historical investment result

GET /api/calculators/investment/

Required query parameters are asset, amount, start, and end. Dates must use the YYYY-MM-DD format. The start date must be within the supported market-data range for the selected asset.

GET /api/calculators/investment/?asset=BTC&amount=10000&start=2020-01-01&end=2025-01-01

The response includes the calculated result and the start and end prices. It does not include the historical price series.

The response separately identifies Coin IRA as the calculation provider and the exchange used for historical market data.

Limits

Supported assets are BTC, ETH, XRP, and SOL. Each client can make up to 30 retirement projection requests per minute, 6 historical calculator requests per minute, and 30 MCP transport requests per minute. A limited request returns HTTP 429 and a Retry-After header.

Authentication

The calculator services do not require registration or credentials. The REST APIs accept anonymous HTTPS GET requests. MCP accepts anonymous Streamable HTTP POST requests. See auth.md for the complete agent access policy.

Important information

Results are educational estimates. They are not forecasts or investment, tax, or legal advice. Historical results do not include fees, spreads, taxes, or actual execution prices.