Ramp Integration

The Ramp integration provides access to manage Ramp corporate cards, bills, reimbursements, and spend controls through the Integrate MCP server.

Installation

The Ramp integration is included with the SDK:

import { rampIntegration } from "integrate-sdk/server";

Setup

1. Create a Ramp OAuth App

1. Go to Ramp Developer Portal
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Ramp integration to your server configuration. The integration automatically reads RAMP_CLIENT_ID and RAMP_CLIENT_SECRET from your environment variables:

import { createMCPServer, rampIntegration } from "integrate-sdk/server";
 
export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    rampIntegration({
    }),
  ],
});

You can override the environment variables by passing explicit values:

rampIntegration({
  clientId: process.env.CUSTOM_RAMP_ID,
  clientSecret: process.env.CUSTOM_RAMP_SECRET,
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";
 
await client.authorize("ramp");
const result = await client.ramp.listTransactions({});
 
console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, rampIntegration } from "integrate-sdk";
 
const customClient = createMCPClient({
  integrations: [rampIntegration()],
});

Configuration Options

export interface RampIntegrationConfig {
  /** Ramp OAuth client ID (defaults to RAMP_CLIENT_ID env var) */
  clientId?: string;

Tools

ramp_list_transactions

List transactions

export interface RampListTransactionsParams {
    /** Filter by start date (YYYY-MM-DD) */
    from_date?: string;

ramp_get_transaction

Get transaction details

export interface RampGetTransactionParams {
    /** Transaction ID */
    transaction_id: string;

ramp_list_cards

List cards

export interface RampListCardsParams {
    /** Filter by card state */
    state?: "ACTIVE" | "INACTIVE" | "SUSPENDED" | "TERMINATED";

ramp_get_card

Get card details

export interface RampGetCardParams {
    /** Card ID */
    card_id: string;

ramp_list_users

List users

export interface RampListUsersParams {
    /** Filter by role */
    role?: "CARD_HOLDER" | "BUSINESS_OWNER" | "BUSINESS_ADMIN" | "BOOKKEEPER";

ramp_get_user

Get user details

export interface RampGetUserParams {
    /** User ID */
    user_id: string;

ramp_list_departments

List departments

export interface RampListDepartmentsParams {
    /** Number of departments to return */
    page_size?: number;

ramp_list_reimbursements

List reimbursements

export interface RampListReimbursementsParams {
    /** Filter by start date (YYYY-MM-DD) */
    from_date?: string;

ramp_get_spend_limits

Get spend limits

export interface RampGetSpendLimitsParams {
    /** Filter by owner ID */
    owner_id?: string;

Notes

• Category: Finance
• Authentication mode: OAuth