PEX MCP Server
The PEX MCP Server provides read-only access to the PEX Card business account platform through 72 tools, enabling AI assistants to retrieve financial, card, and account data.
Business Management: Retrieve business profile, balance, admin details, tags, bank account info, linked businesses, billing information, one-time transfer details, and settings
Card Information: Look up card profiles, spending rules, advanced spending rules, load limit balances, scheduled funding rules, and card orders
Transactions: Fetch paginated business and cardholder transactions with filtering by date, amount, and category; retrieve purchases, declines, attachments, and tags
Account Details: Get cardholder account details, balances, remaining spending limits, and network transactions for both individual cardholders and the entire business
Spending Rulesets: List standard and advanced spending rulesets, see which cards are assigned to each, and look up Merchant Category Code (MCC) categories
Bills & Payments: Search bills, retrieve bill payment details, payment requests, business payments, and payment transfers
Vendors: List vendors, retrieve individual vendor details, and look up vendor card orders
Credit & Invoices: View credit line information, invoices, invoice allocations, and invoice payments
Groups: List cardholder groups and retrieve cardholders belonging to specific groups
Tokens & Provisioning: View current and all authentication tokens, check token provisioning modes, and retrieve issued tokens for cardholders
Callbacks: List available callback subscription types, view all subscriptions, and retrieve individual subscription details
Partner: Retrieve partner details associated with the current business
Key features include input validation with clear error messages, automatic retry logic with exponential backoff for 502/503/504 errors, a 30-second request timeout, and structured JSON logging for debugging.
Provides integration with GitHub Copilot in VS Code, enabling AI assistants to access PEX business account data, cards, transactions, and financial management tools through the PEX External API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PEX MCP Server What is my current business account balance?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PEX MCP Server
A Model Context Protocol (MCP) server that provides access to the PEX Card External API. Use this server to let AI assistants like Claude interact with your PEX business account, cards, transactions, and more.
Getting Your PEX API Token
To use the PEX MCP Server, you need a PEX API token. Follow these steps to generate one:
Log in to the PEX Dashboard using your credentials.
Navigate to Profile > Authorized Apps (or go directly to
/account/authorized-apps).Find the PEX MCP Server application and click on it.
Click Generate Token and copy the token value.
Note: Keep your API token secure. Do not commit it to version control or share it publicly.
Related MCP server: Brex MCP Server
Configuration
Set the following environment variables:
Variable | Required | Description |
| Yes | PEX API base URL (e.g., |
| Yes | Your PEX API token (see Getting Your PEX API Token) |
Usage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"pex": {
"command": "npx",
"args": ["-y", "@pexcard_engineering/mcp"],
"env": {
"PEX_API_URL": "https://coreapi.pexcard.com/v4",
"PEX_API_TOKEN": "your-api-token-here"
}
}
}
}Config file locations
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Usage with Claude Code (CLI)
Add the MCP server using the Claude Code CLI:
claude mcp add pex -e PEX_API_URL=https://coreapi.pexcard.com/v4 -e PEX_API_TOKEN=your-api-token-here -- npx -y @pexcard_engineering/mcpOr add it manually to your .claude/settings.json:
{
"mcpServers": {
"pex": {
"command": "npx",
"args": ["-y", "@pexcard_engineering/mcp"],
"env": {
"PEX_API_URL": "https://coreapi.pexcard.com/v4",
"PEX_API_TOKEN": "your-api-token-here"
}
}
}
}Usage with GitHub Copilot
VS Code
Add the following to your VS Code settings (.vscode/settings.json or user settings):
{
"github.copilot.chat.mcpServers": {
"pex": {
"command": "npx",
"args": ["-y", "@pexcard_engineering/mcp"],
"env": {
"PEX_API_URL": "https://coreapi.pexcard.com/v4",
"PEX_API_TOKEN": "your-api-token-here"
}
}
}
}Alternatively, create an .mcp.json file in your project root:
{
"servers": {
"pex": {
"command": "npx",
"args": ["-y", "@pexcard_engineering/mcp"],
"env": {
"PEX_API_URL": "https://coreapi.pexcard.com/v4",
"PEX_API_TOKEN": "your-api-token-here"
}
}
}
}Tip: When using
.mcp.json, add it to your.gitignoreif it contains your actual token, or use environment variable references to keep secrets out of source control.
Available Tools (72 total)
Business (12 tools)
Tool | Description |
| Get business profile details including name, address, phone, and status |
| Get business account balance |
| Get list of all business administrators |
| Get a specific business administrator by ID |
| Get all business tags |
| Get a specific business tag by ID |
| Get linked businesses |
| Get business bank account details |
| Get business one-time transfer details |
| Get the current user's business profile |
| Get business billing information for a specific month |
| Get business settings |
Cards (7 tools)
Tool | Description |
| Get card profile/details by card account ID |
| Get spending rules for a specific card |
| Get advanced spending rules for a specific card |
| Get remaining card load limit for a specific card |
| Get scheduled funding rules for a specific card |
| Get a specific card order by ID |
| Get card orders within an optional date range |
Transactions (10 tools)
Tool | Description |
| Get paginated business transactions with filters |
| Get a specific business transaction by ID |
| Get paginated cardholder transactions |
| Get a specific cardholder transaction by ID |
| Get paginated cardholder purchases |
| Get a specific cardholder purchase by ID |
| Get paginated cardholder declines |
| Get all attachments for a transaction |
| Get a specific attachment for a transaction |
| Get tags for a specific transaction |
Account Details (10 tools)
Tool | Description |
| Get cardholder account details by ID |
| Get advanced cardholder account details by ID |
| Get all cardholder account details for the business |
| Get account balance for a specific cardholder |
| Get remaining spending limits for a cardholder |
| Get network transactions for the business |
| Get network transactions for a specific cardholder |
| Get transaction details for a specific transaction |
| Get transaction details for the business |
| Get all cardholder transactions within a date range |
Spending Rulesets (7 tools)
Tool | Description |
| Get all spending rulesets for the business |
| Get a specific spending ruleset by ID |
| Get cards assigned to a spending ruleset |
| Get all advanced spending rulesets |
| Get a specific advanced spending ruleset by ID |
| Get cards assigned to an advanced spending ruleset |
| Get Merchant Category Code (MCC) categories |
Bills (4 tools)
Tool | Description |
| Get bill payment details by bill ID |
| Get payments for a specific bill |
| Get a specific bill payment request by ID |
| Search bills with optional filters |
Vendors (3 tools)
Tool | Description |
| Get paginated list of vendors with filters |
| Get a specific vendor by ID |
| Get vendor card order details by order ID |
Payments (3 tools)
Tool | Description |
| Get paginated list of business payments |
| Get a specific payment transfer by ID |
| Get a specific payment request by ID |
Credit & Invoices (4 tools)
Tool | Description |
| Get credit line information for the business |
| Get business invoices starting from a given date |
| Get allocations for a specific invoice |
| Get payments for a specific invoice |
Groups (2 tools)
Tool | Description |
| Get all cardholder groups for the business |
| Get cardholders belonging to a specific group |
Tokens (6 tools)
Tool | Description |
| Get details of the current authentication token |
| Get all tokens for the authenticated user |
| Get basic token details for the authenticated user |
| Get the business token provisioning mode |
| Get token provisioning mode for a cardholder |
| Get issued tokens for a specific cardholder |
Callbacks (3 tools)
Tool | Description |
| Get available callback subscription types |
| Get all callback subscriptions for the business |
| Get a specific callback subscription by ID |
Partner (1 tool)
Tool | Description |
| Get partner details for the current business |
Features
Full API Coverage: 72 tools covering all GET endpoints of the PEX External API
Input Validation: All parameters validated with clear error messages
Retry Logic: Automatic retries with exponential backoff on 502/503/504 errors
Request Timeout: 30-second timeout prevents hanging requests
Structured Logging: JSON logs to stderr for debugging (stdout reserved for MCP)
Rich Documentation: All tool parameters include descriptions, valid values, and constraints
Example Queries
Once connected, you can ask Claude things like:
"What's my business account balance?"
"Show me all transactions from last week over $100"
"List all cards with their spending limits"
"What are the spending rules for card 12345?"
"Show me pending payments"
License
MIT
Available Tools
72 toolspex_get_account_balanceC
Get account balance for a specific cardholder
Inputs: id (required).
pex_get_account_detailsC
Get cardholder account details by account ID
Inputs: id (required).
pex_get_account_remaining_limitsB
Get remaining spending limits for a specific cardholder
Inputs: id (required).
pex_get_advanced_account_detailsC
Get advanced cardholder account details by account ID
Inputs: id (required).
pex_get_advanced_spending_rulesetC
Get a specific advanced spending ruleset by ID
Inputs: id (required).
pex_get_advanced_spending_ruleset_cardsB
Get cards assigned to a specific advanced spending ruleset. Results are paginated.
Inputs: id (required), page, pageSize.
pex_get_all_account_detailsB
Get all cardholder account details for the business. Results are paginated to handle large datasets.
Inputs: page, pageSize.
pex_get_all_cardholder_transactionsB
Get all cardholder transactions within a date range. Results are paginated.
Inputs: startDate (required), endDate (required), includePendings, includeDeclines, +2 more.
pex_get_auth_tokensB
Get a list of basic token details for the authenticated user and app
Inputs: no named parameters.
pex_get_billC
Get bill payment details by bill ID
Inputs: billId (required).
pex_get_bill_payment_requestB
Get a specific bill payment request by ID
Inputs: id (required).
pex_get_bill_paymentsC
Get payments for a specific bill
Inputs: billId (required).
pex_get_business_adminA
Get a specific business administrator by ID
Inputs: id (required).
pex_get_business_adminsB
Get list of all business administrators
Inputs: no named parameters.
pex_get_business_balanceC
Get business account balance
Inputs: no named parameters.
pex_get_business_bank_accountC
Get business bank account details
Inputs: no named parameters.
pex_get_business_billingA
Get business billing information for a specific month. Current month values are estimates; finalized after billing cycle ends.
Inputs: month (required), year (required).
pex_get_business_linkedD
Get linked businesses
Inputs: no named parameters.
pex_get_business_my_profileB
Get the current user's business profile
Inputs: no named parameters.
pex_get_business_one_time_transferC
Get business one-time transfer details
Inputs: no named parameters.
pex_get_business_profileA
Get business profile details including name, address, phone, and status
Inputs: no named parameters.
pex_get_business_settingsC
Get business settings
Inputs: no named parameters.
pex_get_business_tagB
Get a specific business tag by ID
Inputs: id (required).
pex_get_business_tagsC
Get all business tags
Inputs: no named parameters.
pex_get_business_transactionC
Get a specific business transaction by ID
Inputs: transactionId (required).
pex_get_business_transactionsB
Get paginated business transactions with optional date, amount, and category filters
Inputs: minDate, maxDate, onDate, minAmount, +8 more.
pex_get_callback_subscriptionB
Get a specific callback subscription by ID
Inputs: id (required).
pex_get_callback_typesB
Get available callback subscription types
Inputs: no named parameters.
pex_get_cardC
Get card profile/details by card account ID
Inputs: id (required).
pex_get_card_advanced_spend_rulesC
Get advanced spending rules for a specific card
Inputs: id (required).
pex_get_cardholder_declinesC
Get paginated cardholder declines. Optionally filter by cardholder account ID.
Inputs: cardholderAccountId, minDate, maxDate, onDate, +7 more.
pex_get_cardholder_network_transactionsC
Get network transactions for a specific cardholder within a date range
Inputs: id (required), startDate (required), endDate (required).
pex_get_cardholder_provisioning_modeC
Get token provisioning mode for a specific cardholder
Inputs: id (required).
pex_get_cardholder_purchaseB
Get a specific cardholder purchase by transaction ID, optionally scoped to a cardholder
Inputs: transactionId (required), cardholderAccountId.
pex_get_cardholder_purchasesB
Get paginated cardholder purchases. Optionally filter by cardholder account ID and approval status.
Inputs: cardholderAccountId, approval, minDate, maxDate, +8 more.
pex_get_cardholder_transactionB
Get a specific cardholder transaction by transaction ID, optionally scoped to a cardholder
Inputs: transactionId (required), cardholderAccountId.
pex_get_cardholder_transactionsB
Get paginated cardholder transactions. Optionally filter by cardholder account ID.
Inputs: cardholderAccountId, minDate, maxDate, onDate, +9 more.
pex_get_card_load_limit_remainingC
Get remaining card load limit for a specific card
Inputs: id (required).
pex_get_card_orderB
Get a specific card order by ID
Inputs: id (required).
pex_get_card_ordersB
Get card orders within an optional date range
Inputs: startDate, endDate.
pex_get_card_scheduled_funding_rulesC
Get scheduled funding rules for a specific card
Inputs: id (required).
pex_get_card_spend_rulesC
Get spending rules for a specific card
Inputs: id (required).
pex_get_credit_linesC
Get credit line information for the business
Inputs: no named parameters.
pex_get_current_tokenB
Get details of the current authentication token
Inputs: no named parameters.
pex_get_group_cardholdersB
Get cardholders belonging to a specific group. Results are paginated.
Inputs: id (required), page, pageSize.
pex_get_invoice_allocationsC
Get allocations for a specific invoice
Inputs: id (required).
pex_get_invoice_paymentsC
Get payments for a specific invoice
Inputs: id (required).
pex_get_invoicesC
Get business invoices starting from a given date
Inputs: startDate (required).
pex_get_issued_tokensC
Get issued tokens for a specific cardholder
Inputs: id (required).
pex_get_mcc_categoriesB
Get Merchant Category Code (MCC) categories. Filter by predefined and/or custom categories.
Inputs: includePredefined, includeCustom.
pex_get_network_transactionsB
Get network transactions for the business within a date range. Results are paginated.
Inputs: startDate (required), endDate (required), page, pageSize.
pex_get_partnerB
Get partner details for the current business
Inputs: no named parameters.
pex_get_payment_requestC
Get a specific payment request by ID
Inputs: id (required).
pex_get_paymentsB
Get paginated list of business payments with optional filtering by status, dates, etc.
Inputs: page, size, paymentStatuses, paymentStatusTriggers, +4 more.
pex_get_payment_transferB
Get a specific payment transfer by ID
Inputs: id (required).
pex_get_spending_rulesetC
Get a specific spending ruleset by ID
Inputs: id (required).
pex_get_spending_ruleset_cardsB
Get cards assigned to a specific spending ruleset. Results are paginated.
Inputs: id (required), page, pageSize.
pex_get_token_provisioning_modeB
Get the business token provisioning mode
Inputs: no named parameters.
pex_get_transaction_attachmentC
Get a specific attachment for a transaction
Inputs: transactionId (required), attachmentId (required), attachmentLinkType.
pex_get_transaction_attachmentsC
Get all attachments for a transaction
Inputs: transactionId (required).
pex_get_transaction_detailC
Get transaction details for a specific transaction by ID
Inputs: id (required).
pex_get_transaction_detailsB
Get transaction details for the business within a date range. Results are paginated.
Inputs: startDate (required), endDate (required), includePendings, includeDeclines, +2 more.
pex_get_transaction_tagsC
Get tags for a specific transaction
Inputs: transactionId (required).
pex_get_vendorC
Get a specific vendor by ID
Inputs: id (required).
pex_get_vendor_card_orderC
Get vendor card order details by order ID
Inputs: orderId (required).
pex_list_advanced_spending_rulesetsB
Get all advanced spending rulesets for the business
Inputs: no named parameters.
pex_list_callback_subscriptionsB
Get all callback subscriptions for the business, optionally filtered by type
Inputs: type.
pex_list_groupsB
Get all cardholder groups for the business
Inputs: no named parameters.
pex_list_spending_rulesetsB
Get all spending rulesets for the business
Inputs: no named parameters.
pex_list_tokensB
Get all tokens for the authenticated user
Inputs: no named parameters.
pex_list_vendorsB
Get paginated list of vendors with optional filtering by cardholder, status, and status trigger
Inputs: cardholderAcctId, vendorStatuses, vendorStatusTriggers, pageIndex, +1 more.
pex_search_billsC
Search bills with optional filters
Inputs: createdDateFrom, createdDateTo, dueDateFrom, dueDateTo, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 72 tools
The tools are mostly distinct, but there is notable overlap in areas like cardholder transactions (e.g., pex_get_cardholder_transactions, pex_get_all_cardholder_transactions, pex_get_cardholder_purchases) and business transactions (e.g., pex_get_business_transactions, pex_get_network_transactions, pex_get_transaction_details), which could cause confusion. Descriptions help differentiate some, but the sheer number of similar tools increases ambiguity.
Tool names follow a highly consistent verb_noun pattern, all starting with 'pex_get_' or 'pex_list_' and using snake_case throughout. This predictability makes it easy for agents to parse and understand the naming conventions across all 72 tools.
With 72 tools, the count is excessive for typical MCP server purposes, making it heavy and potentially overwhelming for agents. While the domain (financial/card management) is broad, the tool set could likely be consolidated or scoped more narrowly to improve usability.
The tool set provides extensive coverage for financial and card management operations, including account details, transactions, rules, billing, and administrative functions. Minor gaps might exist, such as update or delete operations for some resources, but agents can likely work around these given the comprehensive read-focused surface.
Maintenance
Related MCP Connectors
Discover, inspect and run 63,000+ agent tools from one balance. Pay per call, no subscriptions.
Global B2B intelligence for AI agents: 35M+ companies, 1.6M sanctions, KYB pack. 78 tools.
Verified, pay-per-use API tools for AI agents through one authenticated connection.
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the WYGIWYH expense tracking API through 75 dynamically generated MCP tools. Supports comprehensive financial operations including transaction management, account handling, recurring expenses, and investment tracking.7-
- AlicenseAqualityDmaintenanceEnables interaction with Brex financial data including expenses, budgets, transactions, and accounts through read-only API access with support for pagination, filtering, and receipt management.2123 npmMIT
- AlicenseBqualityNot gradedmaintenanceEnables AI agents to interact with the Brex financial platform, allowing access to account information, transactions, expenses, receipts, budgets, and spend limits through the Brex API.92 npm-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with Conta Azul Financial APIs to manage accounts, balances, and transactions through natural language. It features specialized tools for tracking cash flow, processing payables and receivables, and generating comprehensive financial reports.-