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
  • Compliance
    • Clearance
      • Retrieve a clearance
      • List clearances
    • Entity
      • Retrieve an entity
      • List entities
    • Account Declaration
      • Retrieve an account declaration
      • List account declarations
    • Account Declaration Proof
      • Retrieve an account declaration proof
      • List account declaration proofs
    • Intents
      • Entity Creation
        • Create an entity creation intent
        • Confirm an entity creation intent
        • Retrieve an entity creation intent
        • List entity creation intents
      • Account Declaration Creation
        • Create an account declaration creation intent
        • Confirm an account declaration creation intent
        • Retrieve an account declaration creation intent
        • List account declaration creation intents
      • Account Declaration Revocation
        • Create an account declaration revocation intent
        • Confirm an account declaration revocation intent
        • Retrieve an account declaration revocation intent
        • List account declaration revocation intents
      • Account Declaration Proof Creation
        • Create an account declaration proof creation intent
        • Confirm an account declaration proof creation intent
        • Retrieve an account declaration proof creation intent
        • List account declaration proof creation intents
      • Account Declaration Proof Answer
        • Create an account declaration proof answer intent
        • Confirm an account declaration proof answer intent
        • Retrieve an account declaration proof answer intent
        • List account declaration proof answer intents
  • 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 closure intent
        • List virtual account closure 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
  • Issuing
    • Cardholder
      • Retrieve a cardholder
      • List cardholders
    • Card Program
      • Retrieve a card program
      • List card programs
    • Card
      • Reveal a card's details
      • Retrieve a card
      • List cards
    • Card Transaction
      • Retrieve a card transaction
      • List card transactions
    • Card Transaction Event
      • Retrieve a card transaction event
      • List card transaction events
    • Intents
      • Cardholder Creation
        • Create a cardholder creation intent
        • Confirm a cardholder creation intent
        • Retrieve a cardholder creation intent
        • List cardholder creation intents
      • Card Creation
        • Create a card creation intent
        • Confirm a card creation intent
        • Retrieve a card creation intent
        • List card creation intents
      • Card Update
        • Create a card update intent
        • Confirm a card update intent
        • Retrieve a card update intent
        • List card update intents
      • Card Closure
        • Create a card closure intent
        • Confirm a card closure intent
        • Retrieve a card closure intent
        • List card closure intents
  • Sumsub (Provider)
    • Applicant
      • Create an access token for an applicant
      • Create a WebSDK link for an applicant
      • Retrieve an applicant
      • List applicants
    • Applicant Action
      • Create an access token for an applicant action
      • Create a WebSDK link for an applicant action
      • Retrieve an applicant action
      • List applicant actions
    • Intents
      • Applicant Action Creation
        • Create an applicant action creation intent
        • Confirm an applicant action creation intent
        • Retrieve an applicant action creation intent
        • List applicant action creation intents
      • Applicant Creation
        • Create an applicant creation intent
        • Confirm an applicant creation intent
        • Retrieve an applicant creation intent
        • List applicant creation intents
      • Applicant Update
        • Create an applicant update intent
        • Confirm an applicant update intent
        • Retrieve an applicant update intent
        • List applicant update intents
  • DCS (Provider)
    • Decard Customer
      • Retrieve a decard customer
      • List decard customers
    • Intents
      • Decard Customer Creation
        • Create a decard customer creation intent
        • Confirm a decard customer creation intent
        • Retrieve a decard customer creation intent
        • List decard customer creation intents
  • 🚧 CMS (Provider)
    • Application
      • Retrieve an application
      • List applications
    • Entity
      • Retrieve an entity
      • List entities
    • Intents
      • Application Creation Intent
        • Create an application creation intent
        • Confirm an application creation intent
        • Retrieve an application creation intent
        • List application creation intents
      • Entity Creation Intent
        • Create an entity creation intent
        • Confirm an entity creation intent
        • Retrieve an entity creation intent
        • List entity creation intents
  1. MCP for AI Agents ✨

JSON Configuration

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
{
  "servers": {
    "fomo-mcp-simulator": {
      "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://simulator.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"
      }
    }
  }
}
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
Overview 🗺️
Next
Create an incoming transfer
Built with