Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Ramp in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Let your AI read your Ramp account: cards, funds and spend limits, transactions, reimbursements, bills, vendors, receipts, statements, GL accounts and users. Read-only OAuth scopes; it cannot send or approve payments. Card lock and memo actions are optional and off by default.
Try asking
Example prompts for Ramp
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Ramp, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Ramp + ChatGPT
Let your AI read your Ramp account: cards, funds and spend limits, transactions, reimbursements, bills, vendors, receipts, statements, GL accounts and users. Read-only OAuth scopes; it cannot send or approve payments. Card lock and memo actions are optional and off by default.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
RAMP_CLIENT_ID, RAMP_CLIENT_SECRET
Step 1 — Get credentials
It cannot move money or approve anything, by design. The connector has no tool for bill payments, reimbursement payouts, transfers, card issuing or limit changes, not even a switched-off one, and it cannot approve a bill, a reimbursement or a transaction. Finance can ask the AI about spend without giving it a way to pay.
- Sign in to
https://app.ramp.comas an admin or business owner and open Company, then Developer. Click Create New App, name it (for example AnythingMCP) and accept the terms. - Under Grant types, add Client Credentials.
- Under Scopes, click Configure allowed scopes and allow all of these read-only scopes:
business:read,users:read,departments:read,locations:read,entities:read,cards:read,funds:read,spend_programs:read,transactions:read,reimbursements:read,bills:read,vendors:read,receipts:read,accounting:read,statements:read. The connector asks for every one of them when it gets a token, so each must be allowed in the app; if one is missing, Ramp refuses the token with invalid_scope. - Copy the Client ID into
RAMP_CLIENT_IDand the Client Secret intoRAMP_CLIENT_SECRET, then install the connector. AnythingMCP gets an access token (valid for 10 days) and renews it on its own. - Check the setup with
ramp_get_business: it shows your business name and whether reimbursements are on.
Never allow these for this app: bills:write, reimbursements:write, cards:read_vault, limits:write. With the read scopes above, the token cannot change anything in Ramp.
Switched off at install: ramp_lock_card and ramp_unlock_card (suspend a lost card and lift the suspension again) and ramp_update_transaction_memo (sets the memo, up to 255 characters, and replaces the old one). To use them, allow cards:write or memos:write in the Ramp app, add the same scope to the scope list in the connector's OAuth settings and switch the tool on. The AI then shows you the card name and last four digits, or the transaction and the new memo, and waits for your yes. Ramp's cards:write scope would also let software issue cards; this connector has no such tool.
Financial data is sensitive: balances, transactions, bills, reimbursements, cards and employee details are confidential company data. Share the MCP server only with people allowed to see them; the AI reads only what you ask for. Full card numbers and CVCs are never returned (Ramp's card vault is not used), and bank account details of entities and vendors, and vendor tax ids, are left out.
What it reads: business details and balance (card limit, available limit, statement balance and billing dates); users, departments, locations and entities; physical and virtual cards; funds (spend limits) with balance and restrictions, and spend programs; card transactions with merchant, category, memo, receipts and accounting sync status, where requires_memo finds the ones still missing a memo; out-of-pocket and mileage reimbursements; Bill Pay bills with approval status and due and paid dates; vendors with their spend totals; receipts with a temporary download link and, if you ask, the amounts Ramp read from them; general ledger accounts synced from your accounting system; and card statements with a temporary PDF link.
Amounts: a transaction amount is a plain number in dollars (90.0), while amount objects are in cents (9000 means 90.00 USD). The AI converts them.
Sandbox: with an app from Ramp's sandbox, change the connector's base URL to https://demo-api.ramp.com/developer/v1 and its token URL to https://demo-api.ramp.com/developer/v1/token. Production and sandbox credentials are separate.
Rate limit: 200 requests per 10 seconds per IP address; a 429 means waiting a few seconds.
Common errors: no access token: the client ID or secret is wrong, Client Credentials is not added, or a scope is not allowed in the app (invalid_scope). 403: the token lacks the scope of that tool. 404 with DEVELOPER_7002: Ramp does not know the token, for example a sandbox app used against production; Ramp answers 404 here instead of 401. Any other 404: the id does not exist.
The connector does not pay bills or reimbursements, move money, issue or terminate cards, change funds and limits, approve anything, upload receipts or manage users, vendors and accounting setup.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in ChatGPT
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.
- Go to chatgpt.com/plugins, click +, then Add custom MCP server.
- Enter a name, e.g. Name:
Ramp. - Under Connection, enter the Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDand keep Authentication on OAuth. - Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
- Install the new plugin from your personal plugins, then type @ in a chat and pick it.
Available tools
| Tool | What it does |
|---|---|
ramp_get_business | Read the Ramp business: id, legal name, name on cards, active flag, billing address, website and whether reimbursements are on |
ramp_get_business_balance | Read the Ramp business balance: card limit, available card limit, card balance including pending, statement balance and the previous and… |
ramp_list_users | List Ramp users with id, name, email, role, status, department, location, manager and entity |
ramp_get_user | Read one Ramp user by id: name, email, role, status, department, location, manager and entity |
ramp_list_departments | List the departments in Ramp (id and name) |
ramp_list_locations | List the locations in Ramp (id, name and business entity) |
ramp_list_entities | List the business entities (subsidiaries) in Ramp with id, name, currency, whether it is the primary entity, its locations and the… |
ramp_list_physical_cards | List Ramp physical cards with id, display name, card holder, last four digits, state, whether it is suspended (locked), fund and shipping… |
ramp_get_physical_card | Read one Ramp physical card by id: display name, card holder, last four digits, state, suspended flag, fund and shipping status |
ramp_list_virtual_cards | List Ramp virtual cards with id, owner user id, fund id and whether the card is suspended |
ramp_get_virtual_card | Read one Ramp virtual card by id: owner user id, fund id and suspended flag |
ramp_list_funds | List Ramp funds (spend limits) with name, state, balance (cleared, pending, total), spending restrictions (limit, interval, allowed and… |
ramp_get_fund | Read one Ramp fund (spend limit) by id: balance, spending restrictions, spend program, members and cards |
ramp_list_spend_programs | List Ramp spend programs (templates for funds, such as a travel or education stipend) with name, description, permitted spend types and… |
ramp_get_spend_program | Read one Ramp spend program by id: name, description, permitted spend types and restrictions |
ramp_list_transactions | List Ramp card transactions with amount (in dollars), currency, state, time, merchant, category, memo, card, card holder, fund, receipts… |
ramp_get_transaction | Read one Ramp transaction by id with amounts (original and merchant currency), merchant and location, category, memo, card holder… |
ramp_list_reimbursements | List Ramp reimbursements (out-of-pocket and mileage) with type, state, merchant, memo, amounts, transaction date, submission, approval and… |
ramp_get_reimbursement | Read one Ramp reimbursement by id: type, state, merchant, memo, amounts, dates, employee, fund, trip and receipts |
ramp_list_bills | List Ramp Bill Pay bills with invoice number, status and status summary, approval status, amount, vendor, owner, issue, due and paid dates… |
ramp_get_bill | Read one Ramp bill by id: invoice number, statuses, amount, vendor, owner, dates, payment method, line items and invoice links |
ramp_list_vendors | List the vendors in Ramp with name, legal name, active flag, country, category, owner, ERP id, payment terms, default payment method and… |
ramp_get_vendor | Read one Ramp vendor by id: names, status, country, category, owner, ERP id, payment terms, default payment method and spend totals |
ramp_list_receipts | List receipts uploaded to Ramp with the transaction or reimbursement they belong to, the user and a temporary download link |
ramp_get_receipt | Read one Ramp receipt by id: transaction or reimbursement, user, creation date and a temporary download link |
ramp_list_gl_accounts | List the general ledger accounts synced from the accounting system into Ramp, with id, name, code, classification (for example EXPENSE)… |
ramp_list_statements | List Ramp card statements with period, opening and ending balance, charges, credits, payments and a temporary PDF link |
ramp_get_statement | Read one Ramp statement by id: period, balances, charges, credits, payments and a temporary PDF link |
ramp_lock_card | Suspend (lock) a Ramp card so it cannot be used, for example when it is lost |
ramp_unlock_card | Lift the suspension of a Ramp card so it can be used again |
ramp_update_transaction_memo | Set the memo of a Ramp transaction (at most 255 characters), for example the business purpose |
Example prompts
- "Which card transactions from last week are still missing a memo or a receipt? List card holder, merchant and amount."
- "Which bills are due in the next 14 days? Show vendor, amount, due date and approval status."
- "Show the reimbursements submitted this month that are not paid yet, grouped by employee."
- "Which funds have less than 20 percent of their limit left in this period?"
- "What is our Ramp statement balance, the available card limit and the next billing date?"
FAQ
Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.
Next steps
Was this guide helpful?
