Ramp MCP server

Connect Ramp to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Ramp MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list cards tool in Ramp
  • Use the list vendors tool in Ramp
  • Use the manage user tool in Ramp
  • Use the list reimbursements tool in Ramp
  • Use the manage limit tool in Ramp
  • Use the manage spend program tool in Ramp

Supported Tools

list_cards

List Cards

List Ramp cards. Select physical or virtual for the current API, or legacy for an existing legacy connection. Current virtual card responses contain fund associations rather than spending restrictions. Legacy route availability depends on the account.

list_vendors

List Vendors

Retrieve a paginated list of vendors from Ramp. Vendors are linked to bills and transactions for categorization and payment processing.

manage_user

Manage User

Invite a new user, update an existing user's details, deactivate, or reactivate a Ramp user. - **invite**: Sends an invitation email to join the Ramp business. Requires email, name, and role. - **update**: Modifies user fields such as department, location, manager, or role. - **deactivate** / **reactivate**: Changes the user's active status.

list_reimbursements

List Reimbursements

Retrieve a paginated list of employee reimbursements. Supports filtering by state, sync status, entity, user, date range, and direction (business-to-user or user-to-business repayments).

manage_limit

Manage Limit

List, get, create, update, or terminate a legacy spending limit or a current Ramp fund. Limits represent individual spending budgets that can be associated with cards and reimbursements. - **list**: Retrieve limits, optionally filtered by spend program, user, or entity. - **get**: Retrieve a specific limit by ID. - **create**: Create a new spending limit with optional spend program linkage. - **update**: Modify a limit's settings. - **terminate**: Permanently terminate a limit.

manage_spend_program

Manage Spend Program

List, get, create, or update Ramp spend programs. Spend programs group funds, users, and cards under shared policies, acting as "blueprints" for consistent spending rules and automated fund provisioning.

get_reimbursement

Get Reimbursement

Retrieve details of a specific reimbursement by ID. Returns full reimbursement data including amount, currency, employee info, merchant, line items, mileage/trip details, and approval status.

manage_card

Manage Card

Create, update, suspend, unsuspend, or terminate a Ramp card. - **create_virtual**: Issue a new virtual card for a user with optional spending restrictions. - **create_physical**: Issue a new physical card with shipping fulfillment details. - **update**: Modify card display name, owner, or spending restrictions. - **suspend** / **unsuspend**: Temporarily lock or unlock a card. - **terminate**: Permanently deactivate a card.

get_transaction

Get Transaction

Retrieve details of a specific Ramp card transaction by its ID. Returns full transaction data including amount, currency, merchant, card holder, category, memo, receipts, and policy violations.

get_business

Get Business Info

Retrieve information about the connected Ramp business account, including business name, status, and optionally the account balance.

list_transactions

List Transactions

Retrieve card transactions from Ramp. Supports filtering by date range, merchant, user, sync status, and more. Returns paginated results with transaction details including amount, merchant, category, and card information.

list_bills

List Bills

Retrieve a paginated list of bills from Ramp. Supports filtering by status, vendor, entity, sync status, payment status, due date range, and invoice number.

manage_bill

Manage Bill

Create, update, retrieve, or archive a Ramp bill (accounts payable). - **get**: Retrieve a specific bill by ID. - **create**: Create a new bill with vendor, invoice currency, issue/due dates and line items. Bills created via API are automatically approved. - **update**: Modify an approved bill's fields. - **archive**: Archive/delete a bill.

list_users

List Users

Retrieve a paginated list of Ramp users. Supports filtering by department, location, and entity.

list_entities

List Entities

Retrieve business entities (for multi-entity businesses). Entities are used to organize users, cards, and transactions for reporting and policy enforcement. Can also fetch a specific entity by ID.

manage_department

Manage Department

List, get, create, or update a Ramp department. Departments organize users, cards, and transactions for reporting and policy enforcement.

get_resource

Get Resource

Read a specific Ramp user, vendor, department, location, spend program, fund, physical card, or virtual card by its own identifier. Discover IDs through list tools and resource relationships; a legacy limit ID is not assumed to identify a fund.

get_task_status

Get Task Status

Check a deferred user invitation task. STARTED and IN_PROGRESS mean it is still pending; ERROR is a failed task, and SUCCESS should be followed by a user readback. Requires users:write. Legacy card and limit task receipts are not supported by this endpoint.

Connect Ramp to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Ramp in Metorial. In your Metorial portal, enable the Ramp MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Ramp tools.

Run Ramp through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Ramp and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Ramp tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Ramp

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Freeagent

Manage FreeAgent contacts, invoices, estimates, supplier bills, expenses, projects, tasks, and timeslips. Browse bank accounts and transactions, identify the connected user, download invoice PDFs, and retrieve financial reports.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Harvest

Track time, manage projects, clients, tasks, users, expenses, invoices, and estimates. Discover authorized accounts and your current profile, browse business records, generate structured reports, email invoices, and record invoice lifecycle events.

Technical notes for Ramp

Read transactions, reimbursements, vendors, entities and business balances. Manage users, departments, spend programs, approved bills, physical cards and funds, with exact resource readbacks and deferred user-task status. Bill creation may initiate payment; termination is permanent.

Frequently asked questions

Common questions about connecting Ramp to AI agents with Metorial.

  1. How many tools does the Ramp MCP server have?
    The Ramp MCP server exposes 18 tools, including List Cards, List Vendors, Manage User. Each one is governed and traced through Metorial.
  2. Ramp exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Ramp MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Ramp and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Ramp MCP server yourself or use the hosted gateway.

Connect Ramp to production AI agents

See how Metorial gives your team governed access to Ramp, with tracing and security controls built in.