Getting started

Quickstart

Connect an agent to Ramp in a few minutes via MCP or the CLI.

Pick the path that matches where your agent runs. Use the demo MCP server for sample data, or production when you are ready to authorize against your Ramp workspace.

Option A — MCP (conversational assistants)

Ramp ships a remote MCP server at https://mcp.ramp.com/mcp.

For Cursor, add Ramp with the one-click deeplink or paste this into ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ramp": {
      "url": "https://mcp.ramp.com/mcp"
    }
  }
}

For Claude Code, add the server from your terminal:

claude mcp add --transport http ramp https://mcp.ramp.com/mcp

Most clients will open a browser OAuth flow the first time the assistant needs Ramp. After authorization, try:

Show me my recent Ramp transactions and call out anything unusual.

For Claude, ChatGPT, Perplexity, and custom clients, see MCP setup or the Connectors pages.

Want to explore without touching live data? Swap in the demo server https://demo-mcp.ramp.com/mcp for sample data.

Option B — Ramp CLI (terminal and scripted agents)

Install the CLI, then authenticate:

curl -fsSL https://agents.ramp.com/install.sh | sh
ramp auth login

ramp auth login opens a browser-based OAuth flow. Confirm who you're acting as:

ramp users me

The CLI defaults to the Sandbox environment. Point it at production when you're ready:

ramp transactions list --env production

For agent loops, prefer commands that can return structured output and disable interactive prompts:

ramp transactions list --agent --no-input --quiet --env production

Next steps