Ramp

oficial

Interactúa con la API de desarrollador de Ramp para ejecutar análisis de tus gastos y obtener información aprovechando los LLMs.

GitHub

¿Qué puedes hacer con Ramp MCP?

Cargar datos financieros en una base de datos en memoria — use load_transactions, load_bills, load_reimbursements y otras herramientas de carga para extraer datos de Ramp en una base de datos SQLite efímera para su análisis.
Consultar datos cargados con SQL — ejecutar consultas SQL arbitrarias contra la base de datos en memoria usando execute_query para filtrar, agregar o unir conjuntos de datos cargados.
Obtener datos de referencia directamente — recuperar categorías de Ramp y monedas admitidas a través de get_ramp_categories y get_currencies sin cargarlas en la base de datos.
Gestionar la base de datos efímera — procesar respuestas de API sin procesar en tablas consultables con process_data y limpiar tablas usando clear_table cuando termine.

Documentación

ramp-mcp: Un servidor MCP de Ramp

Descripción general

Un servidor del Protocolo de Contexto de Modelo para recuperar y analizar datos o ejecutar tareas para Ramp usando la API de desarrollador. Para sortear las limitaciones de tokens y tamaño de entrada, este servidor implementa una canalización ETL simple + una base de datos sqlite efímera en memoria para el análisis por parte de un LLM. Todas las solicitudes se realizan a demo de forma predeterminada, pero se puede cambiar configurando RAMP_ENV=prd. Es posible que los conjuntos de datos grandes no se puedan procesar debido a las limitaciones de la API y/o de su cliente MCP.

Herramientas

Herramientas de base de datos

Herramientas que se pueden usar para configurar, procesar, consultar y eliminar una base de datos efímera en memoria.

process_data
execute_query
clear_table

Herramientas de obtención

Herramientas que se pueden usar para obtener datos directamente

get_ramp_categories
get_currencies

Herramientas de carga

Cargan datos al servidor que el cliente puede obtener. Según las herramientas que desee usar, asegúrese de habilitar esos alcances en su cliente de Ramp e incluya los alcances al iniciar el servidor como argumento de CLI.

Herramienta	Alcance
load_transactions	transactions:read
load_reimbursements	reimbursements:read
load_bills	bills:read
load_locations	locations:read
load_departments	departments:read
load_bank_accounts	bank_accounts:read
load_vendors	vendors:read
load_vendor_bank_accounts	vendors:read
load_entities	entities:read
load_spend_limits	limits:read
load_spend_programs	spend_programs:read
load_users	users:read

Para conjuntos de datos grandes, se recomienda indicar explícitamente a Claude que no use REPL y que mantenga las respuestas concisas para evitar tiempos de espera o un uso excesivo de tokens.

Configuración

Configuración de Ramp

Cree un nuevo cliente desde la página de desarrollador de Ramp (Perfil en la parte superior derecha > Desarrollador > Crear aplicación)
Otorgue los alcances que desee (según las herramientas) al cliente y habilite las credenciales de cliente (Haga clic en Aplicación > Tipos de concesión / Alcances)
Incluya el ID de cliente y el secreto en el archivo de configuración, así como los alcances que desee usar

Configuración local

Clone este repositorio de Github a través de git clone git@github.com:ramp/ramp-mcp.git o equivalente
Instale uv

Uso

Ejecute el servidor MCP desde su CLI con:

RAMP_CLIENT_ID=... RAMP_CLIENT_SECRET=... RAMP_ENV=<demo|prd> uv run ramp-mcp -s <COMMA-SEPARATED-SCOPES>

Configuración

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json:

{
  "mcpServers": {
    "ramp-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/<ABSOLUTE-PATH-TO>/ramp-mcp", // make sure to update this path
        "run",
        "ramp-mcp",
        "-s",
        "transactions:read,reimbursements:read"
      ],
      "env": {
        "RAMP_CLIENT_ID": "<CLIENT_ID>",
        "RAMP_CLIENT_SECRET": "<CLIENT_SECRET>",
        "RAMP_ENV": "<demo|qa|prd>"
      }
    }
  }
}

Si este archivo aún no existe, cree uno en /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/

Licencia

Copyright (c) 2025, Ramp Business Corporation Todos los derechos reservados. Este código fuente está licenciado bajo la Licencia MIT que se encuentra en el archivo LICENSE en el directorio raíz de este árbol de código fuente.