Ntropy MCP Server

How to use

You interact with the Ntropy MCP server using an MCP client such as uvx or a compatible launcher. Start by starting the server with your Ntropy API key, then call the available tools to create or update account holders, enrich transactions, and retrieve data. The server provides endpoints to check connectivity, manage account holders, enrich individual or multiple transactions, and fetch or delete records.

Set your API key when you start the server so all subsequent calls authenticate correctly. You can verify connectivity to ensure your key is valid and the Ntropy API is reachable.

You can use these primary operations to integrate Ntropy capabilities into your workflows: - check_connection to verify access - set_api_key to configure or update the API key at runtime - create_account_holder and update_account_holder to manage holder records - enrich_transaction and bulk_enrich_transactions to annotate transactions with Ntropy data - get_account_holder, list_transactions, get_transaction to read data - delete_account_holder and delete_transaction to remove data These actions enable your agents to enrich and reason over banking data with Ntropy intelligence.

How to install

Prerequisites: You need a runtime that can launch MCP servers and support the MCP protocol. The Ntropy MCP server runs in a local process or container and is started with your Ntropy API key.

Choose one of the following start methods and run the appropriate command.

uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

Configuration for desktop or container launch

If you are configuring a desktop client, add the MCP server entry to your CLI configuration so that your client can start the server with the required API key.

"mcpServers": {
  "ntropy-mcp": {
    "command": "uvx",
    "args": [
      "ntropy-mcp",
      "--api-key",
      "YOUR_NTROPY_API_KEY"
    ]
  }
}

Container-based start

If you prefer running the MCP server in a container, use the docker run command shown here. This starts the server with the API key injected as a parameter.

docker run -i --rm ntropy-mcp --api-key YOUR_NTROPY_API_KEY

check_connection

Verify connection to the Ntropy API and return the current connection status information.

set_api_key

Set or update the Ntropy API key at runtime and return the status of the update and validation.

create_account_holder

Create a new account holder with an identifier, type, and name, and return the created holder details.

update_account_holder

Update an existing account holder's name or type and return the updated holder details.

enrich_transaction

Enrich a single transaction with Ntropy data using its id, description, date, amount, entry type, currency, account holder, and optional country.

get_account_holder

Retrieve details for a specific account holder by id.

list_transactions

List transactions for a given account holder with optional limit and offset.

get_transaction

Get details for a specific transaction by transaction id.

bulk_enrich_transactions

Enrich multiple transactions in one operation and return a list of enriched results.

delete_account_holder

Delete an account holder and all associated data.

delete_transaction

Delete a specific transaction by its id.