READMEmain

Stripe MCP Client

A lightweight JavaScript client for interacting with Stripe's Model Context Protocol (MCP) server to create payment links. This client is designed to be used inside your own MCP server to enable integration with Stripe's payment services.

Note: This code was generated by Claude 3.7 Sonnet. Video

Features

Simple API for creating Stripe payment links
Lightweight wrapper around the MCP client
Supports custom options and connected accounts
Automatic management of the MCP connection

Installation

npm install stripe-mcp-client

Make sure you have Node.js 16+ installed.

Dependencies

This package depends on:

@modelcontextprotocol/sdk: For the MCP client implementation
@stripe/mcp: For the Stripe MCP server (peer dependency)

Usage

Basic Usage

import StripeMcpClient from 'stripe-mcp-client';

async function createPaymentLink() {
  // Initialize the client
  const client = new StripeMcpClient({
    apiKey: 'your_stripe_api_key', // Or set STRIPE_API_KEY env var
    debug: true, // Optional: Enable debug logging
  });

  try {
    // Connect to the Stripe MCP server
    await client.connect();

    // Create a payment link
    const paymentLink = await client.createPaymentLink({
      line_items: [
        {
          price: 'price_123', // Your Stripe price ID
          quantity: 1,
        },
      ],
      after_completion: {
        type: 'redirect',
        redirect: {
          url: 'https://example.com/thank-you',
        },
      },
    });

    console.log(`Payment link created: ${paymentLink.url}`);
    return paymentLink;
  } finally {
    // Always close the connection when done
    await client.close();
  }
}

createPaymentLink().catch(console.error);

Using with Environment Variables

// Set in your environment: STRIPE_API_KEY, STRIPE_ACCOUNT (optional)
import StripeMcpClient from 'stripe-mcp-client';

async function createPaymentLink() {
  const client = new StripeMcpClient();
  try {
    await client.connect();
    const paymentLink = await client.createPaymentLink({
      line_items: [{price: 'price_123', quantity: 1}],
    });
    return paymentLink;
  } finally {
    await client.close();
  }
}

Using Within Your Own MCP Server

import {McpServer} from '@modelcontextprotocol/sdk/server/mcp.js';
import {StdioServerTransport} from '@modelcontextprotocol/sdk/server/stdio.js';
import StripeMcpClient from 'stripe-mcp-client';
import {z} from 'zod';

// Create your MCP server
const server = new McpServer({
  name: 'My Payment Server',
  version: '1.0.0',
});

// Add a tool that creates Stripe payment links
server.tool(
  'create_payment_link',
  'Create a Stripe payment link for checkout',
  {
    product_name: z.string().describe('Name of the product'),
    price_amount: z.number().describe('Price amount in cents'),
    currency: z
      .string()
      .default('usd')
      .describe('Currency code (default: usd)'),
  },
  async ({product_name, price_amount, currency}) => {
    // Initialize the Stripe MCP client
    const stripeClient = new StripeMcpClient();

    try {
      await stripeClient.connect();

      // Create a payment link using the Stripe MCP server
      const paymentLink = await stripeClient.createPaymentLink({
        line_items: [
          {
            price_data: {
              currency: currency,
              product_data: {
                name: product_name,
              },
              unit_amount: price_amount,
            },
            quantity: 1,
          },
        ],
      });

      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify({
              payment_link_url: paymentLink.url,
              payment_link_id: paymentLink.id,
            }),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error creating payment link: ${error.message}`,
          },
        ],
        isError: true,
      };
    } finally {
      await stripeClient.close();
    }
  }
);

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

Configuration Options

The StripeMcpClient constructor accepts the following options:

Option	Type	Default	Description
apiKey	string	process.env.STRIPE_API_KEY	Your Stripe API key
tools	string	'paymentLinks.create'	Comma-separated list of Stripe tools to enable
stripeAccount	string	process.env.STRIPE_ACCOUNT	Optional Stripe Connect account ID
debug	boolean	false	Enable debug logging

API Reference

`new StripeMcpClient(options)`

Creates a new client instance.

`client.connect()`

Connects to the Stripe MCP server. Called automatically by other methods if needed.

`client.createPaymentLink(options)`

Creates a new payment link with the specified options.

Parameters:

options: An object containing the Stripe Payment Link creation parameters

Returns:

A Promise that resolves to the created payment link object

`client.close()`

Closes the connection to the Stripe MCP server.

Testing

npm test

License

MIT

stripe-mcp-client