mcpField
C
Currency Converter x402

Currency Converter x402

Remote
github.comFinance0Updated 8w ago

About Currency Converter x402

Currency Converter x402 is an MCP server and pay-per-call API for converting fiat and cryptocurrencies. It uses ECB rates for fiat and CoinGecko for crypto, returning the rate source and timestamp.

Key features

  1. 01Fiat and crypto conversions
  2. 02ECB rates for fiat currencies
  3. 03CoinGecko rates for crypto
  4. 04Rate source and timestamp in results

Use cases

  1. 01Convert prices between fiat and crypto
  2. 02Generate invoices in another currency
  3. 03Value a portfolio in local currency

MCP support

Exposes the `finance_convert_currency` tool to MCP clients. API calls use x402 payments in USDC on Base.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://currency-converter.api.klymax402.com/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

Currency Converter API

MCP Server x402 License: MIT

Fiat and crypto currency converter -- ECB rates for fiat, CoinGecko for crypto. Instant cross-rate lookup. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "currency-converter": {
      "url": "https://currency-converter.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

curl -X POST "https://currency-converter.api.klymax402.com/api/convert" \
  -H "Content-Type: application/json" \
  -d '{"amount":"1","from":"...","to":"..."}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

ToolMethodPathPriceDescription
finance_convert_currencyPOST/api/convert$0.003Convert between fiat currencies and cryptocurrencies
finance_convert_currency

Use this when you need to convert between any currencies -- both fiat (USD, EUR, GBP, JPY) and crypto (BTC, ETH, SOL). Returns conversion result in JSON.

Parameters

NameTypeRequiredDescription
amountnumberyesAmount to convert
fromstringyesSource currency code (e.g., USD, EUR, BTC, ETH)
tostringyesTarget currency code (e.g., EUR, GBP, USD, BTC)

Returns

  • convertedAmount -- the resulting amount in target currency
  • exchangeRate -- the rate used for conversion
  • from -- source currency code
  • to -- target currency code
  • amount -- original amount provided
  • rateSource -- data source used (ECB for fiat, CoinGecko for crypto)
  • timestamp -- when the rate was fetched

Example response:

{"convertedAmount":2815.40,"exchangeRate":0.9218,"from":"USD","to":"EUR","amount":3054.00,"rateSource":"ECB","timestamp":"2026-04-13T12:00:00Z"}

When to use: price conversions across fiat and crypto in a single call. Essential for international pricing, invoice generation, and portfolio valuation in local currency.

Not for: market data or charts (use finance_get_token_price), DeFi swap quotes (use dex_get_swap_quote), wallet balances (use wallet_get_portfolio).

Example agent prompts

  • "Convert between any currencies -- both fiat (USD, EUR, GBP, JPY) and crypto (BTC, ETH, SOL)"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
  • Network: Base L2 (eip155:8453)
  • Asset: USDC
  • Facilitator: Coinbase CDP (primary), PayAI (fallback)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.