The Prism MCP Server exposes your payment platform as tools that any MCP-compatible AI agent can discover and use. It targets providers managing their Prism integration programmatically — querying payments, configuring Points of Service, managing wallets, and monitoring earnings — all from within an AI assistant.
| Property | Value |
|---|
| Server URL | https://prism-mcp.fd.xyz |
| Transport | Streamable HTTP |
| Authentication | OAuth Authorization Code Flow with PKCE |
Account Model
Each authenticated caller is a Provider (tenant) identified by their account. Providers own one or more Points of Service (PoS) — the core unit representing a payment integration. Most tools operate within a PoS context.
- If
posId is omitted, tools automatically default to the provider’s first active PoS.
- IDs are GUIDs throughout (e.g.,
posId, walletId, paymentId, apiKeyId).
Connection Setup
Add the Prism MCP server to your MCP client using the server URL above. Authentication uses OAuth Authorization Code Flow — the first connection opens a browser for you to sign in with your District Pass.
Claude Desktop
Cursor / Windsurf
Custom Agent
Add to your claude_desktop_config.json:{
"mcpServers": {
"prism": {
"type": "http",
"url": "https://prism-mcp.fd.xyz"
}
}
}
Add the server URL https://prism-mcp.fd.xyz in your editor’s MCP settings panel. The OAuth flow triggers automatically on first use.
Connect using any MCP client library. The server implements standard Streamable HTTP transport with OAuth 2.0 PKCE authentication.MCP Server: https://prism-mcp.fd.xyz
Transport: Streamable HTTP
Auth: OAuth 2.0 Authorization Code + PKCE
“What Prism tools do you have available?”
The agent should list all 15 tools. Then try:
“Show me my Points of Service.”
All tools return JSON. Errors use { "error": "CODE", "message": "description" }.
MCP clients discover all tool parameters automatically on connection. CLI users can run fdx prism <tool> --help to see full parameter details. No need to memorize — the tooling tells you what it needs.
Provider
| Tool | Description |
|---|
getProviderInfo | Get provider profile, available blockchain chains, and supported tokens |
updateAccountType | Set the provider account type to Personal or Business |
Points of Service
A Point of Service (PoS) is the top-level entity representing one payment integration. Most tools operate within a PoS context — if posId is omitted, your default active PoS is used.
| Tool | Description |
|---|
listPointsOfService | List all PoS owned by the authenticated provider |
getPointOfServiceDetails | Get full details for a PoS including configuration, assets, networks, and wallets |
createPointOfService | Create a new PoS with name and accepted assets/networks configuration |
updatePointOfService | Update, activate, or deactivate a PoS |
configurePointOfService | Read or update assets, networks, or wallets configuration for a PoS |
Wallets
Manage on-chain wallet addresses registered to a PoS for receiving settlement funds.
| Tool | Description |
|---|
listWallets | List all wallets registered for a PoS |
manageWallet | Create, update, or delete a wallet for a PoS |
API Keys
Manage API keys that authenticate your application against the Prism Gateway.
| Tool | Description |
|---|
listApiKeys | List API keys for a PoS (secret values are never returned) |
manageApiKey | Create, disable, or delete an API key. Secret returned only on creation |
Payments
| Tool | Description |
|---|
listPayments | List payments with blockchain transaction details, asset info, and status |
getPaymentDetails | Get full details for a single payment including settlement breakdown and fees |
Dashboard
| Tool | Description |
|---|
getEarnings | Earnings summary (total gross earnings) for a PoS within a time range |
getRecentPayments | Recent payment summaries for dashboard views |
Example Interactions
Once connected, you can ask your AI agent questions like:
"List my active Points of Service."
"Show me all payments from the last 30 days."
"What are my total earnings this month?"
"Create a new API key named 'production-v2' for my default PoS."
"Add a USDC wallet on Base (chain ID 8453) with address 0xABC... to my PoS."
"Disable API key <id>."
"Get the full details for payment <id>."
Error Handling
All tools return structured errors:
{ "error": "ERROR_CODE", "message": "Human-readable description" }
| Error Code | Meaning |
|---|
MISSING_POS_ID | posId required but omitted (e.g., for activate action) |
INVALID_PAYMENT_ID | paymentId is not a valid GUID |
MISSING_NAME | Name parameter required but not provided |
INVALID_ACTION | Unknown action value passed to an action-discriminated tool |
INVALID_ACCOUNT_TYPE | Account type must be Personal or Business |
MISSING_WALLET_ID | walletId required but not provided or not a valid GUID |
MISSING_API_KEY_ID | apiKeyId required but not provided or not a valid GUID |
