currencyguard avatar

CurrencyGuard Guard Pricing

com.currencyguard/guard-pricing

Connects to CurrencyGuard's FX protection API to help payment service providers and SMEs manage currency risk. You get access to live spot and forward rates, can price out FX Guards (their hedging products), calculate settlement dates, and handle the operational details of currency protection without building against their REST API directly. Reach for this when you're building financial tooling that needs real-time forex data or wants to embed FX hedging capabilities, especially if you're working in the payments or treasury management space where automated currency protection matters.

tools
11
transport
HTTP
last updated
Apr 22, 2026

Install

From registry metadata
$ npx add-mcp https://api.currencyguard.com/mcp --name guard-pricing

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http guard-pricing https://api.currencyguard.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 11 tools

Verified live against the running server on Nov 6, 2026.

get_spot_rateGet an indicative spot FX rate for a currency pair. Returns a rounded indicative mid rate, for illustration purposes only — not for execution. Example: base=GBP, quote=USD returns the GBPUSD rate.2 params

Get an indicative spot FX rate for a currency pair. Returns a rounded indicative mid rate, for illustration purposes only — not for execution. Example: base=GBP, quote=USD returns the GBPUSD rate.

Parameters* required
base*string
Base currency ISO code, e.g. GBP
quote*string
Quote currency ISO code, e.g. USD
list_supported_currenciesList the currency pairs currently available for Guard pricing. Always call this rather than assuming which pairs are supported — the list is configuration-driven and changes.

List the currency pairs currently available for Guard pricing. Always call this rather than assuming which pairs are supported — the list is configuration-driven and changes.

No parameters. Call it with no arguments.

get_forward_rateUse when you need a forward FX rate. tenor accepts either a period such as 1W, 1M, 3M, 6M, 1Y, or an exact date in ISO form YYYY-MM-DD. Use an exact date whenever you need the forward for the same day a Guard settles: a period resolves to the forward curve's own date, which ca...3 params

Use when you need a forward FX rate. tenor accepts either a period such as 1W, 1M, 3M, 6M, 1Y, or an exact date in ISO form YYYY-MM-DD. Use an exact date whenever you need the forward for the same day a Guard settles: a period resolves to the forward curve's own date, which ca...

Parameters* required
base*string
Base currency ISO code, e.g. GBP
quote*string
Quote currency ISO code, e.g. USD
tenor*string
Tenor period such as 1W, 1M, 3M, 6M, 1Y, or an exact date as YYYY-MM-DD
price_guardPrice a Guard — CurrencyGuard's FX protection product for real future payments or receipts. If a tenor like '3 months' is given, call resolve_settlement_date first to get the exact date, then call this tool. THE AMOUNT. Give exactly ONE of foreignAmount and netGuardAmount, nev...7 params

Price a Guard — CurrencyGuard's FX protection product for real future payments or receipts. If a tenor like '3 months' is given, call resolve_settlement_date first to get the exact date, then call this tool. THE AMOUNT. Give exactly ONE of foreignAmount and netGuardAmount, nev...

Parameters* required
foreignAmountnumber
The invoice or bill amount in the foreign currency. Give this OR netGuardAmount, not both.
foreignCurrency*string
Foreign currency ISO code, e.g. USD
guardCurrency*string
Home/base currency ISO code, e.g. GBP
guardRatenumber
Fixed Guard rate to price at instead of the current market rate. Leave empty to price at the current rate.
netGuardAmountnumber
The amount the customer wants in the home currency AFTER the Guard fee: what they bank (RECEIVE) or the most they pay, fee included (PAY). The server then works out the foreign amount. Give this OR...
payReceive*string
PAY if paying foreign currency, RECEIVE if receiving itone of PAY · RECEIVE
settlementDate*string
Settlement date in ISO format YYYY-MM-DD
compare_guard_with_forwardUse when a user asks whether a Guard is worth it, how it compares with a forward contract from their bank or provider, or what happens if they do nothing. ASK BEFORE YOU CALL. The forward side of this comparison should be the customer's own numbers, not CurrencyGuard's guesses...10 params

Use when a user asks whether a Guard is worth it, how it compares with a forward contract from their bank or provider, or what happens if they do nothing. ASK BEFORE YOU CALL. The forward side of this comparison should be the customer's own numbers, not CurrencyGuard's guesses...

Parameters* required
foreignAmount*number
Amount in foreign currency to protect
foreignCurrency*string
Foreign currency ISO code, e.g. USD
forwardMarginPctnumber
Margin a provider embeds in a forward rate, as a percentage. Used only when providerForwardRate is absent. Default 1. Only set it if the user knows theirs.
guardCurrency*string
Home/base currency ISO code, e.g. GBP
initialMarginPctnumber
Deposit a provider demands at the start, as a percentage of the forward amount. Ask for it. Pass 0 when the provider gives the customer an unsecured line with no deposit. Default 5 when the custome...
marginCallThresholdPctnumber
The adverse move, as a percentage, at which the provider starts to demand more cash. Ask for it. Below it the scenarios show no cash call on the forward. Leave empty when the customer does not know...
payReceive*string
PAY if paying foreign currency, RECEIVE if receiving itone of PAY · RECEIVE
providerForwardRatenumber
The forward rate the customer's own provider last quoted them, as foreign currency per unit of home currency, e.g. 1.3122 for GBPUSD. Ask for it. When given, it replaces the market curve estimate a...
scenarioMovesPctarray
Adverse market moves to show, as percentages. Default 3, 5, 10.
settlementDate*string
Settlement date in ISO format YYYY-MM-DD
resolve_settlement_dateResolve a relative time period (tenor) to a valid business settlement date for a currency pair. Use this when a user says '3 months', '6 months', '1 year', etc. instead of an exact date. The tenor format is: 1D (days), 1W (weeks), 1M (months), 1Y (years). Examples: '3M' = 3 mo...2 params

Resolve a relative time period (tenor) to a valid business settlement date for a currency pair. Use this when a user says '3 months', '6 months', '1 year', etc. instead of an exact date. The tenor format is: 1D (days), 1W (weeks), 1M (months), 1Y (years). Examples: '3M' = 3 mo...

Parameters* required
currencyPair*string
Currency pair, e.g. GBPUSD
tenor*string
Tenor string, e.g. 3M, 6M, 1Y
get_historic_best_worstAnalyze historic best/worst FX performance for a currency pair over a Guard's duration. Uses Bank of England historic rates. Returns a 'performances' array with 6 entries — BEST and WORST for each of three lookback periods (5, 10, 25 years). Each entry contains: performanceTyp...6 params

Analyze historic best/worst FX performance for a currency pair over a Guard's duration. Uses Bank of England historic rates. Returns a 'performances' array with 6 entries — BEST and WORST for each of three lookback periods (5, 10, 25 years). Each entry contains: performanceTyp...

Parameters* required
foreignAmount*number
Amount in foreign currency — MUST match foreignAmount from price_guard
foreignCurrency*string
Foreign currency ISO code — MUST match foreignCurrency from price_guard
guardAmountnumber
Guard amount in base/home currency from the Guard quote (the guardAmount field from the price_guard response). Leave it empty when there is no quote, and the tool uses today's indicative mid spot r...
guardCurrency*string
Home/base currency ISO code — MUST match guardCurrency from price_guard
payReceive*string
MUST be the exact same payReceive value you used in price_guard (PAY or RECEIVE). Do NOT change it.one of PAY · RECEIVE
settlementDate*string
Settlement date in ISO format YYYY-MM-DD — MUST match settlementDate from price_guard
price_guard_extensionGet an indicative price for extending a Guard to a later settlement date. Use it when a customer asks what it costs to extend a Guard. Returns: extensionCost, what the customer pays to extend, in the home currency. Show it as the answer: "Extending to [date] costs [extensionCo...6 params

Get an indicative price for extending a Guard to a later settlement date. Use it when a customer asks what it costs to extend a Guard. Returns: extensionCost, what the customer pays to extend, in the home currency. Show it as the answer: "Extending to [date] costs [extensionCo...

Parameters* required
extendedSettlementDate*string
Extended (new) settlement date in ISO format YYYY-MM-DD
foreignAmount*number
Amount in foreign currency to protect
foreignCurrency*string
Foreign currency ISO code, e.g. USD
guardCurrency*string
Home/base currency ISO code, e.g. GBP
originalSettlementDate*string
Original settlement date in ISO format YYYY-MM-DD
payReceive*string
PAY if paying foreign currency, RECEIVE if receiving itone of PAY · RECEIVE
explain_guard_productExplain the Guard product using CurrencyGuard's approved product and FAQ content. Covers: what the Guard is, how it works, who it is for, how it compares to a forward or to doing nothing, and legal, regulatory, accounting, or eligibility questions. Compare the Guard only with...

Explain the Guard product using CurrencyGuard's approved product and FAQ content. Covers: what the Guard is, how it works, who it is for, how it compares to a forward or to doing nothing, and legal, regulatory, accounting, or eligibility questions. Compare the Guard only with...

No parameters. Call it with no arguments.

net_exposureNet an SME's open foreign-currency bills and invoices, so that a receipt due on or before a payment in the same currency is shown as funding it. Returns the residual on every bill and invoice, a trace of which invoice funds which bill and for how much, per-bucket totals, depen...6 params

Net an SME's open foreign-currency bills and invoices, so that a receipt due on or before a payment in the same currency is shown as funding it. Returns the residual on every bill and invoice, a trace of which invoice funds which bill and for how much, per-bucket totals, depen...

Parameters* required
base_currency*string
The client's home currency, e.g. GBP. Items in this currency are ignored.
bucket_daysinteger
Bucket length. Required for rolling_days.
bucket_mode*string
calendar_month groups by month. rolling_days groups by bucket_days from today. guard_settlement_window makes one bucket per payable, window_days before its due date.one of calendar_month · rolling_days · guard_settlement_window
carry*boolean
true when the client keeps receipts in a wallet or account in that currency, so a surplus can fund a payment in a later bucket. Surplus never rolls backward.
items*array
Open bills and invoices
window_daysinteger
Window length before each payable. Required for guard_settlement_window.
request_provider_availabilityFind out whether Guards can be bought through a particular payment provider or bank. A Guard is always bought through a payment provider, so this cannot be answered without knowing which one the user pays through — CurrencyGuard checks and replies. ASK BEFORE CALLING. Tell the...3 params

Find out whether Guards can be bought through a particular payment provider or bank. A Guard is always bought through a payment provider, so this cannot be answered without knowing which one the user pays through — CurrencyGuard checks and replies. ASK BEFORE CALLING. Tell the...

Parameters* required
companyNamestring
The name of the user's company, if they gave it. Omit otherwise.
emailstring
An email address the user has just given so CurrencyGuard can reply. Omit it unless they offered one for this purpose.
provider*string
The payment provider or bank the user pays foreign currency through, as they named it, e.g. Revolut, Wise, Barclays

Sponsors

Details

Website
www.currencyguard.com
Transport
HTTP
Registry
MCP registry, active
Tools verified
Nov 6, 2026