Current exchange rate for one currency pair

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://bump.sh/allratestoday/doc/allratestoday-api/mcp

Standard setup for AI tools providing an mcp.json file

{
  " AllRatesToday API MCP server": {
    "url": "https://bump.sh/allratestoday/doc/allratestoday-api/mcp"
  }
}

GET /api/rate

Bearer auth Api key query

Live mid-market rate between two currencies, refreshed roughly every 60 seconds. Requires an API key: pass it as Authorization: Bearer art_live_... or, for simple cross-origin GETs, as ?key= (alias ?apiKey=). CORS-enabled.

Query parameters

source string Required

Source currency code (ISO 4217)

Minimum length is 3, maximum length is 3.
target string Required

Target currency code (ISO 4217)

Minimum length is 3, maximum length is 3.
key string

API key (alternative to the Authorization header; apiKey also accepted)
apiKey string

Alias for key — the same query-string fallback under its camelCase name.

Responses

200 application/json

Current rate
Hide response attributes Show response attributes object
- rate number(double) Required
- source string Required
  
  Data source class
400 application/json

Invalid or missing parameters
Hide response attributes Show response attributes object
- error string Required
  
  Error message
- hint string
  
  Optional remediation hint
401 application/json

Authentication required — provide an API key via Authorization: Bearer art_live_... (free keys at https://allratestoday.com/register)
Hide response attributes Show response attributes object
- error string Required
  
  Error message
- hint string
  
  Optional remediation hint
429 application/json

Monthly request limit exceeded (X-Monthly-Limit / X-Monthly-Used / X-Monthly-Resets headers included)
Hide response attributes Show response attributes object
- error string
- used integer
- limit integer
- plan string
- resets_at string(date-time)
- upgrade_url string
502 application/json

Upstream rate provider error
Hide response attributes Show response attributes object
- error string Required
  
  Error message
- hint string
  
  Optional remediation hint

GET /api/rate

curl \
 --request GET 'https://allratestoday.com/api/rate?source=USD&target=EUR' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "rate": 0.92145,
  "source": "mid-market"
}

Response examples (400)

{
  "error": "string",
  "hint": "string"
}

Response examples (401)

{
  "error": "string",
  "hint": "string"
}

Response examples (429)

{
  "error": "Request limit exceeded",
  "used": 42,
  "limit": 42,
  "plan": "free",
  "resets_at": "2026-05-04T09:42:00Z",
  "upgrade_url": "https://allratestoday.com/pricing"
}

Response examples (502)

{
  "error": "string",
  "hint": "string"
}