How do I use movmint-fx-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@movmint-fx-mcp get a quote for converting 1000 USD to EUR" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

movmint-fx-mcp

by nziacbdc

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

movmint-fx-mcp

MCP server for the Movmint FX quoting and capture service. Exposes two tools (get_fx_quote, capture_fx_quote) that LLM clients can call to get live FX rates and execute trades.

Architecture

How it fits together

┌─────────────────────────────────────────────────────────────────┐
│  LLM Client (Claude Desktop / Open WebUI + Ollama)              │
└───────────────────────┬─────────────────────────────────────────┘
                        │
          ┌─────────────▼──────────────┐
          │  Transport layer           │
          │                            │
          │  Option A: stdio           │  ← Claude Desktop spawns
          │    (no port, no proxy)     │    the process directly
          │                            │
          │  Option B: HTTP via mcpo   │  ← Open WebUI / Ollama
          │    localhost:8008          │    connects as tool server
          └─────────────┬──────────────┘
                        │
          ┌─────────────▼──────────────┐
          │  MCP Server (Node.js)      │
          │  src/index.ts              │
          │                            │
          │  Tools:                    │
          │  • get_fx_quote            │
          │  • capture_fx_quote        │
          └─────────────┬──────────────┘
                        │  OAuth2 client_credentials
                        │  Bearer token (cached, auto-refreshed)
          ┌─────────────▼──────────────┐
          │  Movmint API               │
          │  api.nextgen.digitalfiat.app│
          │                            │
          │  POST /fx/quote            │
          │  POST /fx/quote/capture/:id│
          └────────────────────────────┘

MCP Server (`src/index.ts`)

Written in TypeScript using the @modelcontextprotocol/sdk. Key behaviours:

Transport: StdioServerTransport — communicates over stdin/stdout. Does not bind to a network port by itself.
Auth: OAuth2 client_credentials flow. Tokens are cached in memory and refreshed 30 seconds before expiry.
Validation: Tool inputs are validated with zod schemas before the API is called.

Tool: `get_fx_quote`

Calls POST /fx/quote on the Movmint API.

Parameter	Type	Required	Description
`from_currency`	string	Yes	Source currency code (e.g. `BSD`, `USD`)
`to_currency`	string	Yes	Target currency code (e.g. `USDC`, `EUR`)
`amount`	number	Yes	Amount in `from_currency`
`funding_method`	`IMMEDIATE` \| `DEFERRED`	No	Defaults to `IMMEDIATE`
`tx_configuration`	object	Yes	Client reference ID + source/target payment config
`participants`	array	No	KYC participants (ULTIMATE_ORIGINATOR, ULTIMATE_BENEFICIARY, etc.)

Returns a quote_id valid for approximately 30 seconds.

Tool: `capture_fx_quote`

Calls POST /fx/quote/capture/{quote_id} on the Movmint API.

Parameter	Type	Required	Description
`quote_id`	string	Yes	The `quote_id` returned from `get_fx_quote`

Returns transaction details including the deposit address for funding.

Payment configuration schemas

tx_configuration accepts source_configuration and target_configuration, each with a source_type and an account_configuration that is one of:

Type	Fields
`BANK_ACCOUNT`	`account_number`, `routing_number`, `account_type` (`CHECKING`/`SAVINGS`)
`DLT_WALLET`	`wallet_address`, `network` (`ethereum`/`solana`/`base`/`sanddollar`)
`CARD`	`card_number`, `expiry_date`, `cvv`, `cardholder_name`, `card_type` (`CreditCard`/`DebitCard`)

Related MCP server: ReadyTrader-FOREX

Environment variables

Variable	Default	Required
`CLIENT_ID`	—	Yes
`CLIENT_SECRET`	—	Yes
`MOVMINT_BASE_URL`	`https://api.nextgen.digitalfiat.app`	No
`MOVMINT_TOKEN_URL`	`https://api.nextgen.digitalfiat.app/oauth2/token`	No
`MOVMINT_TOKEN_AUDIENCE`	`fx-service`	No

Store these in a .env file at the project root (never commit it — it is gitignored).

CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret
MOVMINT_BASE_URL=https://api.nextgen.digitalfiat.app
MOVMINT_TOKEN_URL=https://api.nextgen.digitalfiat.app/oauth2/token
MOVMINT_TOKEN_AUDIENCE=fx-service

Bootstrap: running locally

Prerequisites

Node.js 20+
uvx (ships with uv) — for running mcpo without a permanent install

1. Install dependencies and build

cd /path/to/movmint-fx-mcp
npm install
npm run build        # compiles src/ → dist/

2. Option A — Claude Desktop (stdio, no proxy needed)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "movmint-fx": {
      "command": "node",
      "args": ["/absolute/path/to/movmint-fx-mcp/dist/index.js"],
      "env": {
        "CLIENT_ID": "your-client-id",
        "CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Restart Claude Desktop. The tools appear automatically in the tool picker.

2. Option B — Open WebUI + Ollama (HTTP via mcpo)

mcpo is a proxy that wraps any stdio MCP server and exposes it as an OpenAI-compatible HTTP tool server. Open WebUI can then connect to it as a tool source for any hosted model including Ollama models.

Port map (confirmed on this machine)

Service	Port
Ollama	11434
Open WebUI	8080
mcpo (this server)	8008

Step 1 — Create `mcpo-config.json`

Create mcpo-config.json at the project root (it is gitignored):

{
  "mcpServers": {
    "movmint-fx": {
      "command": "node",
      "args": ["/absolute/path/to/movmint-fx-mcp/dist/index.js"],
      "env": {
        "CLIENT_ID": "your-client-id",
        "CLIENT_SECRET": "your-client-secret",
        "MOVMINT_BASE_URL": "https://api.nextgen.digitalfiat.app",
        "MOVMINT_TOKEN_URL": "https://api.nextgen.digitalfiat.app/oauth2/token",
        "MOVMINT_TOKEN_AUDIENCE": "fx-service"
      }
    }
  }
}

Step 2 — Start mcpo

uvx mcpo --port 8008 --config /absolute/path/to/movmint-fx-mcp/mcpo-config.json

Verify it is running:

curl http://localhost:8008/docs        # OpenAPI/Swagger UI
curl http://localhost:8008/openapi.json

Step 3 — Connect Open WebUI

Open WebUI → Admin Panel → Settings → Tools
Add tool server URL: http://localhost:8008
Open WebUI discovers get_fx_quote and capture_fx_quote automatically via the OpenAPI spec
Enable the tools when starting a chat with any Ollama model

3. Development mode (watch + rebuild)

npm run dev      # tsc --watch, rebuilds dist/ on every save

Run mcpo in a separate terminal; it will pick up the rebuilt dist/index.js on the next tool invocation (the Node process is spawned fresh per mcpo request).

Project structure

movmint-fx-mcp/
├── src/
│   └── index.ts          # MCP server — tools, auth, API client
├── dist/                 # Compiled output (gitignored)
├── interactions/
│   └── SD-CAD_SD-USD Collection.postman_collection.json
├── mcpo-config.json      # mcpo proxy config with credentials (gitignored)
├── package.json
├── tsconfig.json
├── .env                  # Local credentials (gitignored)
└── .gitignore

Security notes

mcpo-config.json and .env both contain credentials and are gitignored. Do not commit either file.
The MCP server logs the token request URL and body to stderr for debugging. Avoid piping stderr to shared log aggregators in production.
The quote_id returned by get_fx_quote expires in ~30 seconds. Do not store or reuse stale quote IDs.

Available Tools

2 tools

capture_fx_quoteA

Capture (execute) a previously generated FX quote using its quote_id. The quote must not have expired (valid for ~30 seconds after generation). Returns transaction details including the deposit address for funding.

Inputs: quote_id (required).

get_fx_quoteA

Generate an FX quote for a currency pair and amount. Returns a quote_id valid for ~30 seconds that can be captured to execute the trade.

Inputs: from_currency (required), to_currency (required), amount (required), tx_configuration (required), +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.1/5.0

Scored 2026-06-22 18:25 across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one generates a quote, the other executes it. No overlap or ambiguity.

Naming Consistency5/5

Both tools follow a consistent verb_noun pattern with snake_case: get_fx_quote and capture_fx_quote.

Tool Count4/5

With only 2 tools, the set is minimal but appropriate for a focused FX quote-capture workflow. Slightly thin but not unreasonable.

Completeness3/5

The core flow of getting and capturing a quote is covered, but missing operations like quote status, history, or cancellation create notable gaps.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

crypto-mcp-serverA
com.thenextgennexus
Live cryptocurrency prices and FX rates as agent tools.
Cryptocurrency Finance
2
https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/crypto-mcp-server/mcp
Market Intel MCPA
io.github.selflabbs
Live & historical FX rates and currency conversion for AI agents. No API keys.
Finance Cryptocurrency
2
https://market.selflabbs.com/mcp
Market Intel MCPA
com.datakoot
Live & historical FX rates and currency conversion for AI agents. No API keys.
Finance Open Data
51
https://market.datakoot.com/mcp
finance-mcp-serverA
com.thenextgennexus
Live stock quotes, a stock screener, crypto prices and FX rates as agent tools.
Finance Cryptocurrency
2
https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/finance-mcp-server/mcp

Related MCP Servers

Realtime Exchange Rate MCP
Finance
AllRates-Today
A
license
A
quality
B
maintenance
Provides real-time foreign-exchange rates, historical data, and multi-currency lookups to MCP-compatible AI coding assistants like Claude Code and Cursor.
Updated 8 days ago (2026-11-02 20:35 UTC)
4
802 npm
MIT
ReadyTrader-FOREX
Finance Autonomous Agents
up2itnow0822
A
license
Not graded
quality
B
maintenance
Enables AI agents to perform forex trading operations through brokerages with risk controls and safety guardrails.
Updated 4 days ago (2026-11-06 16:39 UTC)
MIT
finance-mcp
Finance Cryptocurrency Open Data
adididitagain
A
license
A
quality
C
maintenance
Provides live financial data for any LLM agent, including stock quotes, crypto prices, SEC filings, XBRL financials, FX rates, and macro indicators, through ten MCP tools.
Updated 3 months ago (2026-08-07 01:36 UTC)
11
109 npm
1
MIT
market_data
Finance Open Data
qtcypress
F
license
Not graded
quality
B
maintenance
Enables agents to retrieve live quotes, option chains, futures, and FX data, with provenance and fallback behavior.
Updated 2 months ago (2026-09-12 03:59 UTC)
-

movmint-fx-mcp

Architecture

How it fits together

MCP Server (src/index.ts)

Tool: get_fx_quote

Tool: capture_fx_quote

Payment configuration schemas

Environment variables

Bootstrap: running locally

Prerequisites

1. Install dependencies and build

2. Option A — Claude Desktop (stdio, no proxy needed)

2. Option B — Open WebUI + Ollama (HTTP via mcpo)

Port map (confirmed on this machine)

Step 1 — Create mcpo-config.json

Step 2 — Start mcpo

Step 3 — Connect Open WebUI

3. Development mode (watch + rebuild)

Project structure

Security notes

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Realtime Exchange Rate MCP

ReadyTrader-FOREX

finance-mcp

market_data

MCP Server (`src/index.ts`)

Tool: `get_fx_quote`

Tool: `capture_fx_quote`

Step 1 — Create `mcpo-config.json`