Skip to main content
Glama
CMSCardOS

CardOS MCP Server

Official
by CMSCardOS

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CARDOS_API_KEYYesYour CardOS API key
CARDOS_BASE_URLNoOverride the API base URLhttps://cardos.dev/api/v1

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_productsA

List available card products: productCode, currency, issue/topup limits, and whether KYC is required.

get_merchant_ratesA

Per-merchant pricing for products (e.g. for github, google).

get_balanceA

Get an end user's available balance.

issue_cardA

💳 Issue a virtual card to an end user. Money operation — a test key runs in sandbox (no real money). Idempotent: retries do not double-issue.

get_cardA

Masked card details (last4, expiry, status). Raw PAN/CVV are never returned here — use reveal_card.

freeze_cardB

Freeze a card (reversible). Idempotent.

unfreeze_cardA

Unfreeze a frozen card. Idempotent.

close_cardA

Close a card permanently (irreversible). Idempotent.

set_card_pinA

Set a 4-digit PIN. The PIN is not stored by CardOS.

set_card_controlsA

Set soft spend controls (per-transaction / daily / monthly limits, blocked MCC/countries). On breach the card is auto-frozen + an alert is sent (no hard auth-time block).

reveal_cardA

Mint a one-time hosted link that shows full card details (PAN/CVV) to the end user, bypassing you (PCI on CardOS). Short-lived, single-use.

create_card_sessionA

Mint hosted card screens (manage + transactions) on real data, to open in a webview for the end user — bypassing you. Returns manage_url / transactions_url.

list_card_transactionsA

List transactions for a card (amount, currency, commission, FX original amount/currency, merchant, MCC, decline reason, status).

create_depositC

Create a crypto deposit invoice to top up an end-user balance. Money operation — sandbox with a test key. Idempotent.

confirm_deposit_sandboxA

[SANDBOX] Simulate confirmation of a pending deposit (test key only). In live, an on-chain watcher credits it.

simulate_transaction_sandboxA

[SANDBOX] Inject a test card transaction (test key only) to exercise webhooks, analytics, controls and cashback.

get_statementA

An end user's statement (summary: spent/received/fees/holds + line items + balance).

get_spending_analyticsC

Spending breakdown by category (from MCC) for an end user.

file_disputeC

Open a dispute on a transaction.

list_disputesC

List disputes, optionally filtered by user or status.

get_disputeC

Get one dispute by id.

update_disputeC

Update a dispute (status / note / provider reference).

start_kycA

Start KYC for an end user. Returns a hosted url_for_user and a uuid to poll.

get_kyc_statusC

Status of a KYC session by uuid.

register_webhookA

Register an HTTPS endpoint for outbound events (transaction, balance, issued, card_status, kyc). Returns the signing secret once.

list_webhooksA

List registered webhook endpoints (no secrets).

Prompts

Interactive templates invoked by user choice

NameDescription
issue_card_for_userGuide the assistant through issuing a virtual card for an end user, end to end.
integrate_cardosWalk through integrating CardOS into an app from scratch.

Resources

Contextual data attached and managed by the client

NameDescription
CardOS developer guideAuth, idempotency, webhooks and links — quick orientation for an agent.
CardOS OpenAPI specificationThe full OpenAPI 3 spec (YAML) for the CardOS Tenant API.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/CMSCardOS/cardos-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server