Ryft MCP

ryft-mcp is a Model Context Protocol server for the Ryft API.

It gives MCP clients a clean stdio server for working with Ryft resources such as customers, payment sessions, subscriptions, webhooks, accounts, payouts, disputes, files, and more.

Features

• stdio MCP server built with the official MCP SDK

• Ryft API authentication via environment variables

• structured Ryft API error responses

• account-scoped requests with optional default account support

• multipart file uploads

• DELETE-with-body support for endpoints that require it

• TypeScript, ESLint, unit tests, and build output ready for review or publishing

Tool Coverage

Current tool families include:

• customers

• paymentSessions

• subscriptions

• files

• accounts

• accountLinks

• paymentMethods

• webhooks

• persons

• payoutMethods

• payouts

• transfers

• platformFees

• events

• disputes

• balances

Requirements

• Node.js 20+

• a Ryft secret key

Installation

npm install

Build the server:

npm run build

Quick Start

Run the server locally over stdio:

RYFT_SECRET_KEY=your_secret_key npm run dev

Run the built server:

RYFT_SECRET_KEY=your_secret_key npm start

Optional environment variables:

• RYFT_BASE_URL

  • defaults to https://sandbox-api.ryftpay.com/v1

• RYFT_ACCOUNT_ID

  • default Account header for account-scoped operations

Example MCP Client Configuration

Example stdio configuration:

{
  "mcpServers": {
    "ryft": {
      "command": "node",
      "args": ["/absolute/path/to/ryft-mcp/dist/index.js"],
      "env": {
        "RYFT_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Development

Run typecheck:

npm run check

Run lint:

npm run lint

Run tests:

npm test

Security

ryft-mcp requires API credentials to be supplied by the caller through environment variables. The server will exit immediately if RYFT_SECRET_KEY is missing.

License

MIT