GnistAI GnistAI
Log in

Currency Conversion

Real-time and historical currency conversion — 30+ currencies with ECB reference rates.

Overview   |   MCP Docs   |   API Docs   |   OpenAPI   |   Playground   |   Tutorial   |   Toolkits   |   Home
status: healthy status status healthy healthy tools: 4 tools tools 4 4 Finance

Data source: Frankfurter API (ECB)

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/currency-conversion/
claude_desktop_config.json
{
  "mcpServers": {
    "gnist-currency-conversion": {
      "url": "https://context.gnist.ai/mcp/currency-conversion/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
Shell
curl -X POST "https://context.gnist.ai/mcp/currency-conversion/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "convert_currency", "arguments": {"amount": 1.0, "base": "example", "target": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/currency-conversion/

4 endpoints available:

Shell
curl "https://context.gnist.ai/rest/currency-conversion/convert_currency?amount=1.0&base=example&target=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/currency-conversion/convert_currency",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "amount": 1.0,
        "base": "example",
        "target": "example"
},
)
print(resp.json())

OpenAPI Spec  ·  Full API Docs

CLI Command Line

Command gc currency-conversion

CLI documentation will be available when the GnistAI SDK is published.

Install
pip install gnistai

Available Tools (4)

convert_currency
Convert an amount from one currency to another using real-time or historical rates.
ParameterTypeRequiredDescription
amountnumberrequired
basestringrequired
targetstringrequired
dateanyoptional
get_exchange_rates
Get all exchange rates for a base currency.
ParameterTypeRequiredDescription
basestringoptional (default: "EUR")
dateanyoptional
list_currencies
List all supported currency codes for conversion.
report_feedback
Report a bug, feature request, or general feedback for this data source.
ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: "general")

Related