remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Supports enrichment of Amazon transactions, identifying and categorizing Amazon purchase data in banking records.
Supports enrichment of Netflix subscription transactions, identifying and categorizing streaming service payments in banking records.
Supports enrichment of Starbucks purchase transactions, identifying and categorizing coffee shop expenditures in banking records.

Servidor MCP de Ntropy

Servidor MCP para enriquecer datos bancarios mediante la API de Ntropy. Esto permite a los agentes LLM que trabajan con datos financieros acceder fácilmente a cualquiera de los puntos finales de la API de Ntropy.

Componentes

Herramientas

El servidor implementa las siguientes herramientas para interactuar con la API de Ntropy:

check_connection : verifica la conexión a la API de Ntropy
- Devuelve: Información del estado de la conexión
set_api_key : Establece o actualiza la clave API de Ntropy en tiempo de ejecución
- Parámetros: api_key (cadena)
- Devoluciones: Estado de la actualización y validación de la clave API
create_account_holder : Crea un titular de cuenta
- Parámetros: id (cadena/int), type (cadena), name (cadena)
- Devoluciones: Los detalles del titular de la cuenta creada
update_account_holder : Actualizar un titular de cuenta existente
- Parámetros: id (cadena/int), name (cadena, opcional), type (cadena, opcional)
- Devoluciones: Los datos actualizados del titular de la cuenta
enrich_transaction : Enriquecer una transacción bancaria
- Parámetros: id (cadena/int), description (cadena), date (cadena), amount (flotante), entry_type (cadena), currency (cadena), account_holder_id (cadena/int), country (cadena, opcional)
- Devoluciones: Los datos de transacción enriquecidos
get_account_holder : Obtener detalles del titular de una cuenta
- Parámetros: account_holder_id (cadena/int)
- Devoluciones: Datos del titular de la cuenta
list_transactions : Lista las transacciones de un titular de cuenta
- Parámetros: account_holder_id (string/int), limit (int, valor predeterminado=10), offset (int, valor predeterminado=0)
- Devoluciones: Lista de transacciones
get_transaction : Obtener detalles de una transacción específica
- Parámetros: transaction_id (cadena/int)
- Devoluciones: Detalles de la transacción
bulk_enrich_transactions : Enriquecer múltiples transacciones a la vez
- Parámetros: transactions (Lista de objetos de transacción)
- Devoluciones: Lista de transacciones enriquecidas
delete_account_holder : eliminar un titular de cuenta y todos los datos asociados
- Parámetros: account_holder_id (cadena/int)
- Devoluciones: Estado de eliminación
delete_transaction : Eliminar una transacción específica
- Parámetros: transaction_id (cadena/int)
- Devoluciones: Estado de eliminación

Inicio rápido

Instalar

Primero, obtén tu clave API de Ntropy creando una cuenta en ntropy.com . Asegúrate de reemplazar YOUR_NTROPY_API_KEY con tu clave API.

Ejecute el servidor con uvx

uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

Escritorio de Claude

El archivo de configuración de Claude Desktop normalmente se encuentra en:

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

Agregue lo siguiente al archivo de configuración si usa uvx:

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

y lo siguiente si usas Docker:

"mcpServers": {
  "ntropy-mcp": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "ntropy-mcp"
      "--api-key",
      "YOUR_NTROPY_API_KEY"
    ]
  }
}

Ejemplo de uso

Comprobar conexión

# Check if your API key is valid and the Ntropy API is accessible
connection_status = check_connection()
print(connection_status)

Crear y actualizar titulares de cuentas

# Create a new account holder
account_holder = create_account_holder(
    id="user123",
    type="individual",
    name="John Doe"
)

# Update an existing account holder
updated_account = update_account_holder(
    id="user123",
    name="John Smith"
)

Enriquecer transacciones

# Enrich a single transaction
enriched_transaction = enrich_transaction(
    id="tx123",
    description="AMAZON.COM*MK1AB6TE1",
    date="2023-05-15",
    amount=-29.99,
    entry_type="debit",
    currency="USD",
    account_holder_id="user123",
    country="US"
)

# Bulk enrich multiple transactions
transactions = [
    {
        "id": "tx124",
        "description": "NETFLIX.COM",
        "date": "2023-05-16",
        "amount": -13.99,
        "entry_type": "debit",
        "currency": "USD",
        "account_holder_id": "user123"
    },
    {
        "id": "tx125",
        "description": "Starbucks Coffee",
        "date": "2023-05-17",
        "amount": -5.65,
        "entry_type": "debit",
        "currency": "USD",
        "account_holder_id": "user123"
    }
]
enriched_transactions = bulk_enrich_transactions(transactions)

Depuración

Puede usar el inspector MCP para depurar el servidor. Para instalaciones uvx:

npx @modelcontextprotocol/inspector uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

Construir

Compilación de Docker:

docker build -t ntropy-mcp .

Contribuyendo

¡Aceptamos solicitudes de incorporación de cambios! Siéntete libre de contribuir con nuevas ideas, correcciones de errores o mejoras.

Licencia

ntropy-mcp está licenciado bajo la Licencia MIT. Esto significa que usted tiene libertad de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Permite enriquecer datos bancarios con la API de Ntropy, proporcionando herramientas para crear titulares de cuentas y enriquecer transacciones de manera eficiente.

Related Resources

Reddit Discussion about this server

ntropy-mcp MCP Server