Currencyguard Guard Pricing

by rudialexis

322 downloads
Not rated
GitHub

About

The first payment-contingent FX protection server on MCP. Price a Guard (invoice-linked FX protection for SME invoices and payables), get live spot and forward rates, model 25 years of historic FX stress scenarios, and resolve settlement dates — all via natural conversation. Publ

Details

Author
rudialexis
Downloads
322
Categories
Other

- Invoice-linked FX protection that lapses if the underlying payment doesn't occur.
- No margin calls, collateral, or credit lines required.
- Pay a known premium upfront; keep favourable market moves.
- Tools for live spot rates, forward rates, and historic FX stress data.
- Public, unauthenticated API endpoint.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Currencyguard Guard Pricing
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Access the public, unauthenticated endpoint at https://api.currencyguard.com/mcp. Use the available tools—such as price_guard, get_spot_rate, get_forward_rate, and explain_guard_product—to price protection, view rates, and understand product details. No account setup or credentials are required.

explain_guard_product

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 forwards or options, and legal, regulatory, accounting, or eligibility questions.

get_forward_rate

Get an indicative forward FX rate for a currency pair at a specific tenor. Rates are derived from interest rate differentials, rounded, and for illustration purposes only — not for execution. Returns: forwardRate (indicative mid outright = spot + forward points), forwardPoints (in pips, e.g. -3.1 means the forward rate is 3.1 pips below spot), spotMid (indicative spot mid rate for comparison), settlementDate (the resolved business date for the tenor). Negative forward points mean the forward rate is below spot; positive means above. Example: base=GBP, quote=USD, tenor=3M returns the 3-month GBPUSD indicative forward rate.

get_historic_best_worst

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: type, lookbackYears, startDate/endDate, startRate/endRate, performancePercentage, startAmount, finalAmount, deltaAmount. For Guard-Pay: negative delta = cost decreased = BEST; positive delta = cost increased = WORST. For Guard-Receive: positive delta = receipt increased = BEST; negative delta = receipt decreased = WORST. Parameters must match the values used in the preceding price_guard call, including payReceive (PAY or RECEIVE).

get_spot_rate

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

list_supported_currencies

List all supported currency pairs available for Guard pricing: GBPUSD, GBPEUR, and EURUSD.

price_guard

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. Returns: guardType (Guard-Pay or Guard-Receive), guardRate, guardFee, guardFeePercent, effectiveRate, guardAmount (home currency equivalent), foreignAmount, spotRate, settlementDate, settlementWindowOpens, valid, errors. All quotes are indicative.

price_guard_extension

Get an indicative price for extending a Guard to a later settlement date. Estimates the additional cost using: (1) the guard fee difference between extended and original expiry, (2) the guard spread cost from the roll, and (3) the CurrencyGuard extension margin. Returns a breakdown: extensionCost = feeDifference + guardSpreadCost + extensionMargin. Both the original and extended quotes are priced at the same guard rate (the original quote's strike), so the fee difference reflects purely the longer tenor, not market movement. Use this when a customer asks 'how much would it cost to extend my Guard by X months?' Parameters match price_guard plus the two dates.

resolve_settlement_date

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 months, '6M' = 6 months, '1Y' = 1 year. The returned date accounts for weekends and public holidays in both currencies' financial centres. Use the returned settlementDate as the exact date parameter for price_guard.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "currencyguard guard pricing": {
            "currencyguard": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://api.currencyguard.com/mcp"
                ]
            }
        }
    }
}

McpServers

{
    "currencyguard": {
        "command": "npx",
        "args": [
            "mcp-remote",
            "https://api.currencyguard.com/mcp"
        ]
    }
}

CurrencyGuard Guard Pricing is the first payment-contingent FX protection server on MCP.

What is the Guard?
The Guard is an invoice-linked FX protection instrument — not a derivative, not an FX forward, not a vanilla option. It is tied to a specific payable or receivable. If the underlying payment does not occur, the Guard lapses. No margin calls, no collateral, no credit lines, no open-ended obligations. The SME pays a known premium upfront and keeps the upside if the market moves in their favour.

Tools available:

- price_guard — price protection for a specific invoice or payable
- price_guard_extension — extend an existing Guard to a later settlement date
- get_spot_rate — live spot FX rates (GBPUSD, GBPEUR, EURUSD)
- get_forward_rate — indicative forward rates for any tenor
- get_historic_best_worst — 25 years of historic FX stress data
- resolve_settlement_date — convert tenors to valid business dates
- list_supported_currencies — supported currency pairs
- explain_guard_product — product FAQs and structure

Endpoint: https://api.currencyguard.com/mcp — public, unauthenticated, live now.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.