Ramp MCP Server

MIT License
14
  • Apple

Integrations

  • Implements an ephemeral SQLite database in memory for storing and analyzing financial data, with tools for setting up, querying, and managing database tables

ramp-mcp: Un servidor Ramp MCP

Descripción general

Un servidor de Protocolo de Contexto de Modelo para recuperar y analizar datos o ejecutar tareas para Ramp mediante la API para desarrolladores . Para sortear las limitaciones de tamaño de tokens y entradas, este servidor implementa una canalización ETL simple y una base de datos SQLite efímera en memoria para su análisis por un LLM. Todas las solicitudes se realizan a demo por defecto, pero se pueden modificar configurando RAMP_ENV=prd . Es posible que los conjuntos de datos grandes no se puedan procesar debido a las limitaciones de la API o del cliente MCP.

Herramientas

Herramientas de base de datos

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

  1. process_data
  2. execute_query
  3. clear_table

Herramientas de búsqueda

Herramientas que se pueden utilizar para obtener datos directamente

  1. get_ramp_categories
  2. get_currencies

Cargar herramientas

Carga datos al servidor que el cliente puede recuperar. Según las herramientas que desee utilizar, asegúrese de habilitar estos ámbitos en su cliente Ramp e incluirlos como argumento de la CLI al iniciar el servidor.

HerramientaAlcance
cargar_transaccionestransacciones:leer
reembolsos de cargareembolsos:leer
facturas de cargafacturas:leer
ubicaciones de cargaubicaciones:leer
departamentos_de_cargadepartamentos:leer
cargar_cuentas_bancariascuentas bancarias:leer
proveedores de cargavendedores:leer
cargar cuentas bancarias del proveedorvendedores:leer
entidades_de_cargaentidades:leer
límites de gasto de cargalímites:leer
programas de gasto de cargaprogramas_gastos:leer
cargar_usuariosusuarios:leer

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

Configuración

Configuración de rampa

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

Configuración local

  1. Clone este repositorio de Github mediante git clone git@github.com:ramp/ramp-mcp.git o equivalente
  2. Instalar 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, disponible en el archivo LICENSE del directorio raíz de este árbol de fuentes.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor de Protocolo de Contexto de Modelo que permite el acceso a los datos financieros de Ramp a través de una base de datos en memoria, lo que permite a los LLM analizar transacciones, reembolsos, facturas y otra información financiera de la plataforma de Ramp.

  1. Overview
    1. Tools
  2. Setup
    1. Ramp Setup
    2. Local Setup
  3. Usage
    1. Configuration
      1. Usage with Claude Desktop
    2. License
      ID: 3xpmslpxnk