1. MCP for AI Agents ✨
FOMO API (v20260326)
  • Welcome
    • Onboarding
    • Webhook
    • Version History
  • OAuth2
    • Request an access token
      POST
  • Storage
    • Overview 🗺️
    • File
      • Create a file
      • Retrieve a file
      • Download file content
  • Simulator
    • Overview 🗺️
    • MCP for AI Agents ✨
      • JSON Configuration
    • Incoming Transfer
      • Create an incoming transfer
  • Treasury
    • Overview 🗺️
    • MCP for AI Agents ✨
      • (Option 1) MCP Bundles (Recommended)
      • (Option 2) JSON Configuration (Most Compatible)
    • Account
      • Retrieve an account
      • List accounts
    • Balance
      • Retrieve a balance
      • List balances
    • Transaction
      • Retrieve a transaction
      • List transactions
    • Virtual Account
      • Retrieve a virtual account
      • List virtual accounts
    • Account Holder
      • Retrieve an account holder
      • List account holders
    • Outgoing Transfer
      • Retrieve an outgoing transfer
      • List outgoing transfers
    • Incoming Transfer
      • Retrieve an incoming transfer
      • List incoming transfers
    • Internal Transfer
      • Retrieve an internal transfer
      • List internal transfers
    • Beneficiary
      • Retrieve a beneficiary
      • List beneficiaries
    • Beneficiary Account
      • Retrieve a beneficiary account
      • List beneficiary accounts
    • Quote
      • Retrieve a quote
      • List quotes
    • Trade
      • Retrieve a trade
      • List trades
    • Intents
      • Account Holder Creation
        • Create an account holder creation intent
        • Confirm an account holder creation intent
        • Retrieve an account holder creation intent
        • List account holder creation intents
      • Outgoing Transfer Creation
        • Create an outgoing transfer creation intent
        • Confirm an outgoing transfer creation intent
        • Retrieve an outgoing transfer creation intent
        • List outgoing transfer creation intents
      • Virtual Account Creation
        • Create a virtual account creation intent
        • Set account holder for virtual account creation intent
        • Set account name for virtual account creation intent
        • Set external account for virtual account creation intent
        • Confirm a virtual account creation intent
        • Retrieve a virtual account creation intent
        • List virtual account creation intents
      • Virtual Account Update
        • Create a virtual account update intent
        • Set account name for virtual account update intent
        • Confirm a virtual account update intent
        • Retrieve a virtual account update intent
        • List virtual account update intents
      • Virtual Account Closure
        • Create a virtual account closure intent
        • Confirm a virtual account closure intent
        • Retrieve a virtual account update intent
        • List virtual account update intents
      • Beneficiary Creation
        • Create a beneficiary creation intent
        • Confirm a beneficiary creation intent
        • Retrieve a beneficiary creation intent
        • List beneficiary creation intents
      • Beneficiary Account Creation
        • Create a beneficiary account creation intent
        • Confirm a beneficiary account creation intent
        • Retrieve a beneficiary account creation intent
        • List beneficiary account creation intents
      • Quote Creation
        • Create a quote creation intent
        • Confirm a quote creation intent
        • Retrieve a quote creation intent
        • List quote creation intents
      • Trade Creation
        • Create a trade creation intent
        • Confirm a trade creation intent
        • Retrieve a trade creation intent
        • List trade creation intents
      • Trade Cancellation
        • Create a trade cancellation intent
        • Confirm a trade cancellation intent
        • Retrieve a trade cancellation intent
        • List trade cancellation intents
      • Internal Transfer Creation
        • Create an internal transfer creation intent
        • Confirm an internal transfer creation intent
        • Retrieve an internal transfer creation intent
        • List internal transfer creation intents
  • Compliance
    • Party
      • Retrieve a party
      • List parties
    • Party Attribute
      • Retrieve a party attribute
      • List party attributes
    • Verification
      • Retrieve a verification
      • List verifications
    • Disclosure Consent
      • Retrieve a disclosure consent
      • List disclosure consents
    • Requirement
      • Retrieve a requirement
      • List requirements
    • Capability Grant
      • Retrieve a capability grant
      • List capability grants
    • Collection Session
      • Retrieve a collection session
      • List collection sessions
    • Evidence
      • Retrieve an evidence
      • List evidences
    • Screening
      • Retrieve a screening
      • List screenings
    • Crypto Address
      • Retrieve a crypto address
      • List crypto addresses
    • Travel Rule Message
      • Retrieve a travel rule message
      • List travel rule messages
    • Partner Access
      • Retrieve a partner access
      • List partner accesses
    • Crypto Address Declaration
      • Retrieve a crypto address declaration
      • List crypto address declarations
    • Requirement Type
      • Retrieve a requirement type
      • List requirement types
    • Capability
      • Check a capability
    • Partner
      • Retrieve a partner
      • List partners
    • Intents
      • Verification Creation
        • Create a verification creation intent
        • Set share token for verification creation intent
        • Answer a requirement for verification creation intent
        • Confirm a verification creation intent
        • Retrieve a verification creation intent
        • List verification creation intents
      • Verification Update
        • Create a verification update intent
        • Answer a requirement for verification update intent
        • Confirm a verification update intent
        • Retrieve a verification update intent
        • List verification update intents
      • Party Creation
        • Create a party creation intent
        • Confirm a party creation intent
        • Retrieve a party creation intent
        • List party creation intents
      • Party Attribute Creation
        • Create a party attribute creation intent
        • Confirm a party attribute creation intent
        • Retrieve a party attribute creation intent
        • List party attribute creation intents
      • Party Attribute Update
        • Create a party attribute update intent
        • Confirm a party attribute update intent
        • Retrieve a party attribute update intent
        • List party attribute update intents
      • Crypto Address Creation
        • Create a crypto address creation intent
        • Confirm a crypto address creation intent
        • Retrieve a crypto address creation intent
        • List crypto address creation intents
      • Partner Access Creation
        • Create a partner access creation intent
        • Confirm a partner access creation intent
        • Retrieve a partner access creation intent
        • List partner access creation intents
      • Crypto Address Declaration
        • Create a crypto address declaration intent
        • Confirm a crypto address declaration intent
        • Retrieve a crypto address declaration intent
        • List crypto address declaration intents
  1. MCP for AI Agents ✨

(Option 2) JSON Configuration (Most Compatible)

Supported by most MCP-compatible AI Agents, including Claude Code, VS Code, Cursor.

Prerequisites#

You need the following before setup:
Node.js 20 or later

Configure Your AI Agent#

1
Locate JSON configuration file
Location of the JSON configuration file varies by AI agents. You may refer to your AI agent's documentation if your AI agent is not listed below:
ClientConfiguration location
Claude DesktopFollow the Getting Started with Local MCP Servers guide to open or edit claude_desktop_config.json. (Claude Help Center)
VS CodeOpen .vscode/mcp.json (workspace) or use MCP: Open User Configuration from the Command Palette. (Visual Studio Code)
CursorUse .cursor/mcp.json (project) or ~/.cursor/mcp.json (global). (Cursor Documentation)
2
Choose the template matching your client
VS Code
Standard MCP
UAT
{
  "servers": {
    "fomo-mcp-treasury": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://docs.fomopay.com/artifacts/mcp-proxy-0.1.1.tgz",
        "mcp-proxy"
      ],
      "env": {
        "REMOTE_MCP_URL": "https://treasury.uat.fomoapis.com/v1/mcp",
        "FOMO_TOKEN_URL": "https://oauth2.uat.fomoapis.com/v1/token",
        "FOMO_API_VERSION": "v20260326",
        "FOMO_CUSTOMER_ID": "YOUR_CUSTOMER_ID",
        "FOMO_KEY_ID": "YOUR_KEY_ID",
        "FOMO_SCOPE": "*",
        "FOMO_PRIVATE_KEY_PATH": "/path/to/your/private/key.pem"
      }
    }
  }
}
Prod
3
Prepare environment values
Replace placeholders with real values:
FOMO_CUSTOMER_ID
FOMO_KEY_ID
FOMO_SCOPE (Recommended)
FOMO_PRIVATE_KEY_PATH or FOMO_PRIVATE_KEY
File path method
Inline method
Set FOMO_PRIVATE_KEY_PATH to a local PEM file path.
4
Restart agent and validate
After updating config:
Restart your AI client.
Confirm the MCP server appears as connected.
Run a basic read-only prompt.
If setup is correct, you should receive tool responses via MCP backed by the same business capabilities as your existing FOMO API platform.
Previous
(Option 1) MCP Bundles (Recommended)
Next
Retrieve an account
Built with