Overview
MEXAR MCP Server is a headless Model Context Protocol server that exposes selected MEXAR Core API workflows to AI clients. It lets an operator use natural language to inspect departments, customers, currencies, accounts, transactions, master agents, exchange quotes, and remittance context without building another dashboard surface.
This component is an exploratory V1 prototype, not a public product UI. The design is intentionally conservative because it connects to a real financial operations system: read and lookup tools are the default workflow, while write tools are gated behind explicit confirmation and can be disabled entirely with read-only mode.
Product Architecture
- Thin TypeScript MCP bridge - The server is implemented in TypeScript using the official Model Context Protocol SDK. It runs over stdio, so Claude Code, Claude Desktop, or another MCP-capable client can connect without an HTTP server.
- No backend changes required - The MCP layer wraps the existing MEXAR Core REST API rather than introducing a new backend service or database. This keeps it deployable as an operator-side integration layer.
- Environment-based authentication - Runtime configuration is supplied through
MEXAR_API_BASE_URLandMEXAR_ACCESS_TOKEN. The access token is an existing Laravel Passport bearer token for an employee-identity user. - Domain-oriented tools - Tools are split by operational domain: departments, customers, exchange, remittance, transactions, accounts, master agents, countries, and shared response helpers.
- Read-first operating model - Lookup tools such as
list_my_departments,search_customers,get_customer,quote_exchange,list_transactions,show_transaction,list_accounts, andshow_accountare always registered. - Confirm-gated write tools - Customer creation/update, money changer exchange creation, and remittance creation default to dry-run previews. The tool returns the exact method, endpoint, and payload it would send; execution only happens after calling again with
confirm: true. - Read-only deployment switch -
MEXAR_READONLYdisables write tools entirely, which allows the same server to be used for safer investigation and support workflows. - Human-readable response enrichment - Reference-data helpers resolve currency and country ids into names for selected responses, reducing the amount of raw numeric context an AI client has to interpret.
- Rate and settlement safeguards - Exchange and remittance tools include system quote checks, rate deviation warnings, account lookup support, and explicit notes about when a money changer flow differs from a remittance flow.
Key Capabilities
- Natural-language operations lookup - Ask for customer records, today’s transactions, account balances, department currency setup, or master agent context through an AI client.
- Guided transaction preparation - Resolve department, customer, currency, account, and quote context before preparing exchange or remittance payloads.
- Dry-run financial writes - Preview sensitive CRM, exchange, and remittance writes before execution, keeping a human review step in the workflow.
- Minimal integration footprint - Runs as a local or operator-side MCP process with bearer-token access to the existing API, avoiding an additional public service surface.
- AI-assisted internal tooling - Demonstrates how MEXAR’s existing API architecture can be extended into AI-native operator workflows without rewriting the core platform.
