Ramp

oficial

Interaja com a API de Desenvolvedor da Ramp para realizar análises sobre seus gastos e obter insights utilizando LLMs.

GitHub

O que você pode fazer com Ramp MCP?

Carregar dados financeiros em um banco de dados em memória — use load_transactions, load_bills, load_reimbursements e outras ferramentas de carga para puxar dados do Ramp para um banco de dados SQLite efêmero para análise.
Consultar dados carregados com SQL — execute consultas SQL arbitrárias no banco de dados em memória usando execute_query para filtrar, agregar ou unir conjuntos de dados carregados.
Buscar dados de referência diretamente — recupere categorias do Ramp e moedas suportadas via get_ramp_categories e get_currencies sem carregá-las no banco de dados.
Gerenciar o banco de dados efêmero — processe respostas brutas da API em tabelas consultáveis com process_data e limpe tabelas usando clear_table quando terminar.

Documentação

ramp-mcp: Um servidor MCP da Ramp

Visão geral

Um servidor Model Context Protocol para recuperar e analisar dados ou executar tarefas para a Ramp usando a API do desenvolvedor. Para contornar as limitações de tamanho de tokens e entrada, este servidor implementa um pipeline ETL simples + banco de dados sqlite efêmero em memória para análise por um LLM. Todas as requisições são feitas para demonstração por padrão, mas podem ser alteradas configurando RAMP_ENV=prd. Grandes conjuntos de dados podem não ser processáveis devido às limitações da API e/ou do seu cliente MCP.

Ferramentas

Ferramentas de banco de dados

Ferramentas que podem ser usadas para configurar, processar, consultar e excluir um banco de dados efêmero em memória.

process_data
execute_query
clear_table

Ferramentas de busca

Ferramentas que podem ser usadas para buscar dados diretamente

get_ramp_categories
get_currencies

Ferramentas de carregamento

Carrega dados para o servidor que o cliente pode buscar. Com base nas ferramentas que você deseja usar, certifique-se de habilitar esses escopos no seu cliente Ramp e incluir os escopos ao iniciar o servidor como um argumento CLI.

Ferramenta	Escopo
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 grandes conjuntos de dados, é recomendado instruir explicitamente o Claude a não usar REPL e manter as respostas concisas para evitar timeout ou uso excessivo de tokens.

Configuração

Configuração da Ramp

Crie um novo cliente na página de desenvolvedor da Ramp (Perfil no canto superior direito > Desenvolvedor > Criar aplicativo)
Conceda os escopos desejados (com base nas ferramentas) ao cliente e habilite as credenciais do cliente (Clique em Aplicativo > Tipos de concessão / Escopos)
Inclua o ID e o segredo do cliente no arquivo de configuração, bem como os escopos que deseja usar

Configuração local

Clone este repositório do Github via git clone git@github.com:ramp/ramp-mcp.git ou equivalente
Instale o uv

Uso

Execute o servidor MCP a partir da sua CLI com:

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

Configuração

Uso com o Claude Desktop

Adicione isto ao seu 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>"
      }
    }
  }
}

Se este arquivo ainda não existir, crie um em /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/

Licença

Copyright (c) 2025, Ramp Business Corporation Todos os direitos reservados. Este código-fonte está licenciado sob a Licença MIT encontrada no arquivo LICENSE no diretório raiz desta árvore de código-fonte.