StoneX API MCP Server

The StoneX Payments Model Context Protocol (MCP) server connects your coding assistant to StoneX API operations, enabling foreign exchange trading, payment processing, and investigation management directly from your development environment. The server is distributed as a .NET application and works with MCP-compatible coding assistants including Claude Desktop, Cursor, and other MCP-enabled tools.

StoneX MCP Server Setup

Use the following endpoint to connect your coding tool:

https://mcp.api.sandbox.payments.stonex.com/mcp

Configure the MCP client to connect to the StoneX server. You will need to use authentication keys which can be stored in .env files and pass the necessary auth token in headers using query parameters or the method supported by the tool.

{
    "servers": {
        "StoneX-GlobalPayments-SandBox-External": {
            "url": "https://mcp.api.sandbox.payments.stonex.com/mcp",
            "type": "http"
        }
    }
}

{
    "mcpServers": {
        "StoneX-GlobalPayments-SandBox-External": {
            "url": "https://mcp.api.sandbox.payments.stonex.com/mcp",
            "type": "http"
        }
    }
}

claude mcp add-json StoneX-GlobalPayments-SandBox-External '{ "type": "http", "url": "https://mcp.api.sandbox.payments.stonex.com/mcp" }'

{
    "mcpServers": {
        "StoneX-GlobalPayments-SandBox-External": {
            "url": "https://mcp.api.sandbox.payments.stonex.com/mcp",
            "type": "http"
        }
    }
}

[mcp_servers.StoneX-GlobalPayments-SandBox-External]
type = "http"
url = "https://mcp.api.sandbox.payments.stonex.com/mcp"

How It Works

Run the StoneX MCP Server
Connect your MCP‑compatible AI tool (e.g. Claude Desktop, Cursor)
Authenticate using your StoneX API credentials
Interact with StoneX APIs using natural language prompts

The AI agent handles tool discovery, payload creation, and workflow execution.

Example Prompt

Get me an FX quote for selling 250,000 USD into EUR and book the trade if the rate is above 0.91.

The AI agent will:

Identify the relevant StoneX tools
Generate valid API requests
Execute the workflow
Return structured results

StoneX API Sandbox Tools

The Global Payments MCP server provides the following categories of tools:

Category	Description	Tool
Authentication	Authenticate with StoneX using your sandbox credentials	`stonex_authenticate`
Trade Booking	Get quotes, book trades, manage trade lifecycle, and obtain Dodd-Frank disclosures	`stonex_get_quote`, `stonex_get_bulk_quotes stonex_reject_quote`, `stonex_book_trade` , `stonex_get_trade_status`, `stonex_request_trade_cancel`, `stonex_get_dodd_frank_disclosure`
Payment Instructions	Add and validate delivery instructions for trades	`stonex_add_delivery_instructions`, `stonex_validate_delivery_instructions`, `stonex_get_payment_validation_rules`
Banking Operations	Validate IBANs, lookup BIC/SWIFT codes, and calculate value dates	`stonex_lookup_bic_from_iban`, `stonex_lookup_swift_from_bic`, `stonex_get_value_dates`
Investigation Management	Create, update, close investigations/support tickets, upload files, and retrieve investigation details	`stonex_list_investigations`, `stonex_create_investigation`, `stonex_get_investigation`, `stonex_update_investigation`, `stonex_close_investigation`, `stonex_get_investigation_topics`, `stonex_upload_investigation_file`, `stonex_get_investigation_file`
Webhooks	Manage webhook subscriptions for trade status changes and investigation updates	`stonex_list_webhooks`, `stonex_create_webhook`, `stonex_update_webhook`, `stonex_get_webhook`, `stonex_delete_webhook`
System Health	Check API availability	`stonex_check_api_availability`

Model Context Protocol (MCP) Usage Terms

The StoneX MCP Server is a developer tool that enables AI assisted interaction with StoneX APIs. All API calls made via MCP are treated the same as direct API usage and remain subject to StoneX Development Kit License Agreement.
StoneX does not guarantee the accuracy, completeness, or suitability of any output generated by AI tools using the MCP Server.
Any output, code, scripts, configurations, or requests used in connection with your integration which are generated with the assistance of artificial intelligence (“AI Assisted Code”) shall be used at your sole risk and must not be relied upon without appropriate human review, testing, and validation prior to deployment in any production environments.
You are solely responsible for reviewing any AI-Assisted Code or requests, validating payloads and workflows, detecting and correcting any errors or hallucinations, and ensuring compliance with applicable laws, regulations, and StoneX documentation.
You remain fully responsible for all API activity performed via the MCP Server, including activity initiated by AI agents. This includes responsibility for transactions executed, data submitted or retrieved, compliance with regulatory and contractual obligations.
StoneX does not review, control, endorse, or validate any AI‑Assisted Code and shall have no liability for any claims, losses, damages, or interruptions arising from or related to your use of any AI‑Assisted Code.
StoneX treats MCP initiated API calls the same as any other API call made using your credentials.