financeoauth2

Ramp

Ramp is a platform that helps you manage your finances, track your income and expenses, and get insights into your business

Verdict

Ramp in Switchy gives your team instant access to corporate spend data without leaving chat. @mention Ramp to pull transaction histories, check card limits, review department budgets, or create new virtual cards on the fly. Finance teams use it to answer 'who spent what' questions during budget reviews; managers use it to verify card status before approving purchases. Requires OAuth with read/write scopes for transactions and cards — setup takes about three minutes, but you'll need admin access to your Ramp account to authorize the connection.

Common use cases

  • Audit last month's spend by department
  • Check virtual card limits before vendor calls
  • Pull transaction details for expense reports
  • Create new department for budget tracking
  • Verify cardholder info during onboarding

Integration

Vendor
Ramp
Category
finance
Auth
OAUTH2
Tools
22
Composio slug
ramp

Tools

  • Create Department

    Tool for creating a new department in your ramp organization. perfect for setting up organizational structure and expense categorization.

  • Create New Custom Accounting Field

    Tool for creating a new custom accounting field. note: this operation requires elevated permissions not available in the demo api.

  • Fetch Custom Accounting Field

    Tool for fetching a custom accounting field.

  • Get All Transactions

    Get all the transactions.

  • Get Card

    Tool for retrieving detailed information about a specific card. returns comprehensive card details including spending limits, cardholder info, and fulfillment status. use this to get complete card profile for analysis or troubleshooting.

  • Get Department

    Tool for retrieving detailed information about a specific department. returns comprehensive department details including hierarchy information. use this to get complete department profile for organizational analysis.

  • Get My Cards

    Tool for fetching cards assigned to you, including physical and virtual cards. useful for checking card status, limits, and managing your payment methods.

  • Get My Transactions

    Get my transactions.

  • Get Statement

    Tool for retrieving statement details or downloading statements. supports json, pdf, and csv formats for financial reporting.

  • Get Transaction Details

    Tool for retrieving complete details of a specific transaction. includes merchant details, receipts, accounting codes, and dispute information.

  • Get Vendor Details

    Tool for retrieving detailed information about a specific vendor. returns comprehensive vendor details including spending totals, category, and contact information. use this to get complete vendor profile for analysis or updates.

  • Issue Virtual Card

    Tool for issuing virtual cards to users instantly. creates cards with customizable spending limits and restrictions. returns full card details including card number and cvv.

  • List All Cards

    Tool for listing all cards across the organization with optional filters. returns card details including spending limits, cardholder info, and state. use this to analyze card distribution, monitor card states, or find specific cards.

  • List Departments

    Tool for listing all departments in the organization. returns department details including names, codes, and hierarchy information. use this to analyze organizational structure and department relationships.

  • List Statements

    Tool for listing all statements with filtering options. perfect for financial reporting and reconciliation workflows.

  • List Users

    Tool for listing users in your ramp organization with flexible filtering. perfect for user audits, access management, and organizational analysis. helps identify inactive users, role distribution, and departmental structures.

  • List Vendors

    Tool for listing vendors with their spending information. returns vendor details including spending totals, categories, and activity status. use this to analyze vendor relationships and procurement patterns.

  • Options for Custom Accounting Field

    Tool for listing options for a given accounting field.

  • Search Transactions

    Search transactions with filters.

  • Update Card Spending Limit

    Tool for updating spending limits on a card. note: this returns the limits associated with the card. the actual update might require using the limit id directly via patch /limits/{limit id}.

  • Update Department

    Tool for updating an existing department in your ramp organization. useful for reorganizing departmental structure or renaming departments.

  • Upload New Options for Custom Accounting Field

    Tool for uploading new options for a given accounting field.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Ramp in the MCP directory and click Connect. 3. You'll be redirected to Ramp's OAuth consent screen — log in with an account that has admin permissions. 4. Grant read access to transactions, cards, and departments; grant write access if your team needs to create cards or update accounting fields. 5. After authorizing, Switchy redirects you back and confirms the connection is live. 6. Open any Space, type '@Ramp get my transactions' and send — you should see a list of recent charges within seconds. 7. If the response is empty or errors, check that your Ramp account has at least one posted transaction and that the OAuth token hasn't expired.

What teammates see: by default, memories from Ramp are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Monthly Spend Summary

@Ramp get all transactions from the last 30 days and summarize total spend by department. Highlight any department over budget.
Open in a Space →

Card Limit Check

@Ramp get my cards and show the spending limit and remaining balance for each one.
Open in a Space →

Transaction Lookup

@Ramp get my transactions from the past week and show only charges over $500, including merchant name and date.
Open in a Space →

Department Setup

@Ramp create a new department called 'Product Marketing' and confirm it's ready for expense categorization.
Open in a Space →

Card Details Review

@Ramp get card details for card ID [paste ID here] and show the cardholder, limit, and whether it's been activated.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@ramp show me all my transactions from the last 30 days and break down spending by category

Output

Here's an illustrative summary of your Ramp transactions over the last 30 days: • Software & SaaS: $4,230 (12 transactions) • Travel & Lodging: $2,890 (5 transactions) • Meals & Entertainment: $1,450 (18 transactions) • Office Supplies: $340 (4 transactions) Total spend: $8,910 across 39 transactions. Your largest single transaction was $1,200 for AWS services on the 15th. Three transactions are still pending merchant categorization. Would you like me to drill into any specific category or flag unusual spending patterns?

Notes

This example demonstrates the MCP's read-heavy transaction retrieval paired with AI synthesis. The user needs OAuth2 access with transaction read scope. Note that category breakdowns depend on how your organization has configured merchant categorization rules in Ramp—uncategorized transactions may require manual review.

Prompt

@ramp create a new department called 'Product Marketing' under the Marketing parent department with cost center code PMK-2024

Output

Department created successfully: • Name: Product Marketing • Department ID: dept_abc123xyz • Parent: Marketing (dept_mkt001) • Cost Center: PMK-2024 • Status: Active This department is now available for expense allocation and reporting. Team members can be assigned to this department, and you can set department-specific spending policies or card limits. The department will appear in your accounting exports with the PMK-2024 cost center code for reconciliation.

Notes

This write example shows organizational structure management, a key Ramp capability for multi-team expense tracking. Requires OAuth2 with department write permissions. Be aware that creating departments affects your accounting hierarchy immediately—coordinate with finance before restructuring to avoid breaking existing expense allocation rules or reporting workflows.

Prompt

@ramp pull details on all virtual cards I have access to and flag any that are approaching their monthly spending limit

Output

Here's an illustrative overview of your virtual cards: **Card 1: AWS Infrastructure** (card_virt_001) • Limit: $5,000/month | Spent: $4,720 (94% utilized) ⚠️ • Expires: 12/2025 | Status: Active **Card 2: Marketing Tools** (card_virt_002) • Limit: $2,000/month | Spent: $890 (45% utilized) • Expires: 06/2026 | Status: Active **Card 3: Conference Travel** (card_virt_003) • Limit: $3,000/month | Spent: $150 (5% utilized) • Expires: 03/2025 | Status: Active Your AWS card is at 94% of its monthly limit—consider requesting an increase if you have planned infrastructure expenses this month.

Notes

This synthesis example combines card retrieval with spending analysis, useful for proactive budget management. The MCP returns card metadata and current spend; the AI layers on utilization warnings. Requires card read scope. Monthly limits reset based on your organization's billing cycle, and limit increases typically require manager approval through Ramp's workflow system.

Use-case deep-dives

Monthly close for 15-person startup

When Ramp MCP speeds up expense reconciliation at small scale

A 15-person startup closing books each month spends 3-4 hours reconciling Ramp transactions in QuickBooks. The Ramp MCP wins here because the finance lead can pull all transactions, filter by department or custom field, and cross-check card assignments without toggling between Ramp's UI and their accounting system. The 22 tools cover the full reconciliation loop: fetch transactions, verify department tags, check card limits, and validate custom accounting fields. This works cleanly up to about 500 transactions per month. Beyond that threshold—or if you need multi-entity consolidation—you're better off using Ramp's native QuickBooks sync. The buying call: if your monthly close involves manual Ramp lookups and you're under 30 people, this MCP cuts reconciliation time in half.

Vendor payment approval workflow

How Ramp MCP supports ad-hoc vendor card requests

A 6-person agency handles one-off vendor payments (AWS credits, design tools, freelancer deposits) by issuing virtual cards on demand. The operations manager uses the Ramp MCP to create a virtual card, set a spending limit, assign it to the correct department, and pull the transaction history once the charge posts—all without leaving Slack or their project tracker. The MCP's card creation and retrieval tools make this faster than logging into Ramp's dashboard for each request. The trade-off: if you're issuing more than 10 cards a week, you'll want Ramp's approval workflows and policy engine instead of ad-hoc MCP calls. This scenario works best for teams under 20 people with low card-issuance volume. The call: use this MCP when vendor payments are infrequent and you want to keep approvals inside your existing chat or task tool.

Department budget tracking for ops lead

When Ramp MCP helps ops track spend without a finance hire

A 25-person SaaS company without a dedicated finance person relies on the ops lead to track department spend each week. The Ramp MCP lets the ops lead pull all transactions by department, check which cards are active, and verify that custom accounting fields (like project codes) are tagged correctly. The MCP's department and custom field tools make this a 10-minute weekly check-in instead of a 45-minute Ramp UI session. The boundary: if you need budget alerts, spend forecasts, or policy enforcement, the MCP won't replace Ramp's native reporting or a proper finance tool like Mosaic. This works for teams under 40 people where spend tracking is manual and the ops lead owns the process. The call: if you're pre-finance-hire and need lightweight spend visibility, the Ramp MCP keeps you out of the dashboard.

Frequently asked

What does the Ramp MCP do in Switchy?

It connects your Ramp corporate card program to Switchy's AI workspace. Your team can query transactions, check card details, create departments, and manage custom accounting fields without opening the Ramp dashboard. Useful for finance teams who need to pull spend data or org structure info during planning conversations.

Do I need admin access to connect Ramp via OAuth?

Yes. The OAuth flow requires permissions to read transactions and card data across your organization, not just your own cards. Some tools like creating custom accounting fields explicitly need elevated admin rights. If you're a cardholder without admin access, you can only use the 'Get My Cards' and 'Get My Transactions' tools.

Can the Ramp MCP approve expenses or issue refunds?

No. It's read-heavy with some write access for org structure (departments, accounting fields). You can't approve reimbursements, dispute charges, or modify transactions. For approvals, you still need the Ramp web app. Think of this as a reporting and setup tool, not a full expense management interface.

Why use this instead of exporting CSVs from Ramp?

Speed and context. Your AI can pull live transaction data mid-conversation without you leaving Switchy to download a file. The 22 tools cover department hierarchy and custom fields, which aren't in standard CSV exports. If you only need monthly reconciliation, exports are fine. If you're doing real-time budget checks, the MCP wins.

Who on the team should connect the Ramp integration?

Your finance lead or whoever owns the Ramp admin account. They'll authenticate once via OAuth, and the connection lives in your Switchy workspace. Other team members can then query Ramp data through the AI without needing their own Ramp logins, as long as they're in the workspace.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.