title: Ramp MCP source_url: /developer-api/v1/ramp-mcp summary: Ramp MCP is subject to change. Feedback and questions can be submitted via a Developer API support ticket. content: Ramp MCP is subject to change. Feedback and questions can be submitted via a Developer API support ticket. Need a custom MCP client or gateway? Ramp MCP allows you to securely connect Ramp with AI assistants like ChatGPT and Claude, so you can query Ramp data and take actions with natural language. Admins can analyze data to identify spend trends and forecasting insights, while employees can check balances, request reimbursements, or get policy answers directly from their daily tools. Tools are grouped here by what the user is trying to accomplish, not by tool name — the underlying surface evolves continuously. Disconnect and reconnect your client to pick up new tools. For the full breakdown including agent purchases and channel-specific guidance, see AI Agents. Read and analyze spend — search transactions, pull spend exports, query vendors and accounting categories, load departments and entities, get treasury balances and the org chart. Process approvals — approve or reject transactions, reimbursements, and unified requests (POs, fund requests). Bill approvals are not yet available via MCP. Submit and complete expenses — let employees submit expenses and reimbursements, complete required details, and move their own reimbursement requests forward. Edit, submit, and act on workflows — edit transactions (memo, coding, trip), submit reimbursements, post comments, manage cards (lock, unlock, activate), apply GL coding. Answer questions — policy Q&A, Help Center search, decline explanations. Make purchases — generate Agent Card credentials. See Make purchases with Agent Cards for setup and purchase fit. Manage trips — create trips, view trips, connect transactions to trips, retrieve flight and hotel bookings. Most company-wide data tools (spend exports, vendor management, GL coding) require admin or business-owner permissions. Employees see only their own data; admins see company-wide data. Getting started A Ramp production or sandbox account Access to your chosen AI platform (Claude, ChatGPT, etc.) Using demo data Replace https://mcp.ramp.com/mcp with https://demo-mcp.ramp.com/mcp in any config below to use sample data instead of live Ramp data. Add the Ramp MCP server to your Claude Code session: Run /mcp in your session to verify the connection. Cursor desktop app required The Cursor desktop app must be installed for this one-click link to work. Or add manually to ~/.cursor/mcp.json: Add the following to your Claude Desktop config file: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Add the following to your VS Code MCP settings: For any MCP-compatible client, use the server URL to configure a connection: Production: https://mcp.ramp.com/mcp Demo: https://demo-mcp.ramp.com/mcp Check your tool's MCP documentation for configuration format. If you manage more than one Ramp business, create one MCP connection per business. Ramp treats any unused path in the form https://mcp.ramp.com//mcp as an alias for the production Ramp MCP server, so each client connection can keep its own OAuth session. Use a memorable identifier for each business. For example: Acme Corporate Ramp MCP: https://mcp.ramp.com/acme-corporate/mcp Acme Europe Ramp MCP: https://mcp.ramp.com/acme-europe/mcp Then authenticate each connection while signed in to the matching Ramp business. The identifier in the URL is only a client-side label and routing alias; Ramp permissions still come from the authenticated user and selected business. Do not use developer, employee, mcp, ramp-data, or ramp-rate as business identifiers. Those paths are reserved for Ramp MCP servers or legacy routes. After setup, try a prompt to confirm everything is working: "What Ramp cards do I have?" "Show me my recent transactions" In Claude Code, run /mcp to check that the Ramp server appears in your connected servers list. Off-the-shelf clients (Claude, ChatGPT, Cursor, Claude Code, etc.) work out of the box. Custom MCP clients — and third-party gateways like Glean, MintMCP, or GoSearch — must have their redirect URI allowlisted by Ramp first. Use https:// or localhost/127.0.0.1 only. Exact host required. Wildcard subdomains aren't supported. Open the redirect URI whitelist request form to submit your custom MCP client or third-party gateway for review. Tech partners building a product that connects customers' Ramp accounts apply through the Partner Integrations launch checklist. Microsoft Copilot for 365 Microsoft Copilot for 365 doesn't natively support remote MCP servers. Integrate via Copilot Studio's MCP server integration, or use the Developer API directly through Power Automate. Admins can control which employees have access to Ramp MCP through Integrations: Navigate to Company → Integrations → Ramp MCP in your Ramp dashboard Select 'Manage Access' Set restrictions based on roles, departments, or specific users This provides fine-grained control over who can use AI copilots to access Ramp data and functionality. Employee Tools: Available to all Ramp users, but respect individual user permissions (e.g., users will only see funds and cards available to their account) Admin Tools: Only available to users with admin or business owner permissions Troubleshooting Authentication fails or connection drops: Claude Code: Run /mcp, select Ramp, and choose "Clear authentication" Cursor / Claude Desktop: Remove and re-add the server in your config, then restart the app ChatGPT: Disconnect and reconnect the Ramp app in Settings → Apps Clear cached MCP auth: rm -rf ~/.mcp-auth (if applicable) Ensure you're logged into the correct Ramp account Unsupported redirect URI: Custom MCP clients and third-party gateways must have their exact redirect URI allowlisted by Ramp before the OAuth flow can complete. "ETL operation limit reached": Wait for current data operations to complete Ask the AI to clear unused tables to free up resources "Query returned more than 100 rows": The AI will automatically add more specific filters and retry All questions and feedback about Ramp MCP can be submitted via a Developer API support ticket