{"id":26648442,"url":"https://github.com/ramp-public/ramp-mcp","last_synced_at":"2025-03-25T00:02:09.715Z","repository":{"id":283501339,"uuid":"951969645","full_name":"ramp-public/ramp-mcp","owner":"ramp-public","description":"ramp-mcp","archived":false,"fork":false,"pushed_at":"2025-03-20T15:30:58.000Z","size":25,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-20T20:53:55.893Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ramp-public.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-20T14:26:04.000Z","updated_at":"2025-03-20T18:33:03.000Z","dependencies_parsed_at":"2025-03-20T16:46:40.714Z","dependency_job_id":null,"html_url":"https://github.com/ramp-public/ramp-mcp","commit_stats":null,"previous_names":["ramp-public/ramp_mcp","ramp-public/ramp-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramp-public%2Framp-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramp-public%2Framp-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramp-public%2Framp-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ramp-public%2Framp-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ramp-public","download_url":"https://codeload.github.com/ramp-public/ramp-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245372379,"owners_count":20604491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-25T00:01:58.065Z","updated_at":"2025-03-25T00:02:09.694Z","avatar_url":"https://github.com/ramp-public.png","language":"Python","funding_links":[],"categories":["Business \u0026 Commerce Mcp Servers","Production-Ready Servers","🤖 AI/ML","Finance","官方 MCP 服务器列表","Official Servers","🗂️ Extensions by Category","Knowledge \u0026 Memory","Table of Contents"],"sub_categories":["💰 Finance","Data Science Tools"],"readme":"# ramp-mcp: A Ramp MCP server\n\n## Overview\n\nA Model Context Protocol server for retrieving and analyzing data or running tasks for [Ramp](https://ramp.com) using [Developer API](https://docs.ramp.com/developer-api/v1/overview/introduction). In order to get around token and input size limitations, this server implements a simple ETL pipeline + ephemeral sqlite database in memory for analysis by an LLM. All requests are made to demo by default, but can be changed by setting `RAMP_ENV=prd`. Large datasets may not be processable due to API and/or your MCP client limitations.\n\n### Tools\n\n#### Database tools\n\nTools that can be used to setup, process, query, and delete an ephemeral database in memory.\n\n1. `process_data`\n2. `execute_query`\n3. `clear_table`\n\n#### Fetch tools\n\nTools that can be used to fetch data directly\n\n1. `get_ramp_categories`\n2. `get_currencies`\n\n#### Load tools\n\nLoads data to server which the client can fetch. Based on the tools you wish to use, ensure to enable those scopes on your\nRamp client and include the scopes when starting the server as a CLI argument.\n\n| Tool                      | Scope               |\n| ------------------------- | ------------------- |\n| load_transactions         | transactions:read   |\n| load_reimbursements       | reimbursements:read |\n| load_bills                | bills:read          |\n| load_locations            | locations:read      |\n| load_departments          | departments:read    |\n| load_bank_accounts        | bank_accounts:read  |\n| load_vendors              | vendors:read        |\n| load_vendor_bank_accounts | vendors:read        |\n| load_entities             | entities:read       |\n| load_spend_limits         | limits:read         |\n| load_spend_programs       | spend_programs:read |\n| load_users                | users:read          |\n\nFor large datasets, it is recommended to explicitly prompt Claude not to use REPL and to keep responses concise to avoid timeout or excessive token usage.\n\n## Setup\n\n### Ramp Setup\n\n1. Create a new client from the Ramp developer page (Profile on top right \u003e Developer \u003e Create app)\n2. Grant the scopes you wish (based on tools) to the client and enable client credentials (Click on App \u003e Grant Types / Scopes)\n3. Include the client ID and secret in the config file as well as the scopes you wish to use\n\n### Local Setup\n\n1. Clone this Github repo via `git clone git@github.com:ramp/ramp-mcp.git` or equivalent\n2. Install [`uv`](https://docs.astral.sh/uv/)\n\n## Usage\n\nRun the MCP server from your CLI with:\n\n```bash\nRAMP_CLIENT_ID=... RAMP_CLIENT_SECRET=... RAMP_ENV=\u003cdemo|prd\u003e uv run ramp-mcp -s \u003cCOMMA-SEPARATED-SCOPES\u003e\n```\n\n## Configuration\n\n### Usage with Claude Desktop\n\nAdd this to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"ramp-mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/\u003cABSOLUTE-PATH-TO\u003e/ramp-mcp\", // make sure to update this path\n        \"run\",\n        \"ramp-mcp\",\n        \"-s\",\n        \"transactions:read,reimbursements:read\"\n      ],\n      \"env\": {\n        \"RAMP_CLIENT_ID\": \"\u003cCLIENT_ID\u003e\",\n        \"RAMP_CLIENT_SECRET\": \"\u003cCLIENT_SECRET\u003e\",\n        \"RAMP_ENV\": \"\u003cdemo|qa|prd\u003e\"\n      }\n    }\n  }\n}\n```\n\nIf this file doesn't exist yet, create one in `/\u003cABSOLUTE-PATH-TO\u003e/Library/Application Support/Claude/`\n\n## License\n\nCopyright (c) 2025, Ramp Business Corporation\nAll rights reserved.\nThis source code is licensed under the MIT License found in the LICENSE file in the root directory of this source tree.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Framp-public%2Framp-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Framp-public%2Framp-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Framp-public%2Framp-mcp/lists"}