MX Platform API

Name: MX Platform API
Brand: MX Platform API
Availability: InStock

✓ Official Vendor SpecFinanceBankingbearer, basic166 EndpointsREST

For Agents

Aggregate and enrich financial data from US financial institutions, manage members and accounts, list transactions, and generate connect widgets. Returns enriched transaction streams and verified account data across 166 endpoints.

Install Jentic One Beta

Connect the MX Platform API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the MX Platform API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with MX Platform API.

Connect a user to a financial institution and create a member with their credentials

Sync accounts and transactions from a connected member

Retrieve enriched transactions with category, merchant, and location metadata

GET STARTED

Start building with MX Platform API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use MX Platform API for, with concrete tasks.

★ Personal Finance Aggregation

Aggregate balances and transactions across all of a user's bank, credit card, loan, and investment accounts. The MX Platform API handles institution connect via the Connect widget, member management, periodic account/transaction sync, and enrichment with categories and merchants. Personal finance products use this to render a single net worth and budgeting view from disparate institutions.

Generate a Connect widget URL for the user, then on completion call GET /institutions and the user's member endpoints to sync accounts and list enriched transactions.

Account Verification with Microdeposits

Verify ownership of a US bank account using microdeposits before initiating a higher-value transfer. The microdeposits endpoints initiate two small deposits, accept the user's verification amounts, and return a verified account status. This is the standard pattern lending and payroll products use to confirm that a user controls the destination account.

Call POST on the microdeposits initiate endpoint with the user's account number and routing number, wait 1-2 business days, then submit the deposit amounts to verify ownership.

ACH Return Tracking

Track and reconcile ACH returns when payments fail to settle. The /ach_returns endpoints expose returns by GUID and let products create return records as they arrive from the originating bank. Finance teams use this to surface failed payments quickly and trigger recovery flows for the underlying transaction.

Call GET /ach_returns to list pending returns, then GET /ach_returns/{ach_return_guid} to read the return reason for each and update the originating payment record.

Transaction Categorization Overrides

Override default transaction categorization for a specific user or rule pattern. MX's enrichment automatically assigns categories like Groceries or Utilities, but users sometimes need custom buckets. The transaction rules endpoints let products define matchers and target categories that override the default mapping for that user's transactions.

Create a transaction rule that matches description containing 'COFFEE' and assigns the 'Coffee Habit' category, then verify recent transactions are recategorized.

AI Agent Personal Finance Assistant

Power a Jentic-driven agent that answers natural-language questions about a user's spending and balances. The agent searches Jentic for 'list user transactions', loads the relevant member endpoint, and aggregates results into the answer. Jentic injects the bearer or basic credentials at execution time so the agent never holds raw banking credentials.

Through Jentic, search for 'list transactions for a member', load the operation, sync recent transactions, and return total spending in the Restaurants category for the last 30 days.

Key Endpoints

166 endpoints — the mx platform api aggregates financial data from tens of thousands of financial institutions and enriches it with categorization, merchant matching, and account verification.

METHOD

PATH

DESCRIPTION

GET

/institutions

List supported institutions

GET

/institutions/{institution_code}

Read a specific institution

POST

/authorization_code

Request an authorization code

GET

/ach_returns

List ACH returns

POST

/ach_returns

Create an ACH return record

GET

/categories/default

List default transaction categories

GET

/merchants

List merchants

GET

/merchants/{merchant_guid}

Read a merchant

GET

/institutions

List supported institutions

GET

/institutions/{institution_code}

Read a specific institution

POST

/authorization_code

Request an authorization code

GET

/ach_returns

List ACH returns

POST

/ach_returns

Create an ACH return record

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your MX bearer and basic credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'list user transactions' or 'verify a bank account', and Jentic returns the matching MX operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using MX Platform API through Jentic.

What authentication does the MX Platform API use?

MX supports both HTTP bearer authentication and HTTP basic authentication using a client ID and API key issued from the MX dashboard. Through Jentic, both credential types are stored in your Jentic One instance and applied to requests at execution time, so agent code never sees the raw credentials.

Can I connect a user's bank account with the MX Platform API?

Yes. Generate a Connect widget URL via the widgets endpoints, render the URL in your app, and let the user pick their institution and authenticate. MX returns a member object that subsequent /accounts and /transactions calls reference.

How do I list a user's transactions through Jentic?

Through Jentic, search for 'list a member's transactions', load the relevant member transactions operation, and pass the user GUID and member GUID. Jentic returns the enriched transaction list with category, merchant, and location metadata to your agent.

What are the rate limits for the MX Platform API?

MX enforces per-client rate limits documented in their developer portal rather than the OpenAPI spec. Watch for 429 responses and respect the Retry-After header; production limits are typically negotiated per partner agreement.

Does the MX Platform API support microdeposit verification?

Yes. The microdeposits endpoints let you initiate two small deposits to a destination account and then submit the user-reported amounts to confirm ownership. This is the standard verification flow before initiating ACH transfers.

Can the MX Platform API enrich transactions with merchant data?

Yes. Transaction responses include resolved merchants linked to /merchants/{merchant_guid} records, plus default categories from /categories/default. Use transaction rules to override the defaults for a specific user.

Can I limit what my agent is allowed to do with the MX Platform API?

Yes. Because you run Jentic One yourself, your own rules decide which MX Platform operations and which stored credentials the agent may use, so a read-only view of accounts and transactions never includes a write call like creating an ACH return unless you add that operation. MX puts resource ids in the URL path, such as /institutions/{institution_code} and /merchants/{merchant_guid}, so a rule can pin the agent to a single institution or merchant rather than the whole catalog. The agent only ever reaches the endpoints you have explicitly allowed.

MX Platform API

Connect the MX Platform API to your agent

Capabilities

Start building with MX Platform API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs