What You'll Set Up

By the end of this guide, your AI agent will be able to manage your Stripe account — listing customers, creating payment links, processing refunds, and more. The entire setup takes about five minutes.

Stripe

50 tools · Automate payments, invoices, and revenue ops

Before You Begin

Make sure you have:

A Stripe account — Create one for free if you don't have one
A Pipeworks workspace — Sign up at pipeworks.ai if you haven't already

Info

You can use Stripe's test mode API key to try things out before connecting your live account. Test mode keys start with sk_test_.

Steps

Get your Stripe API key

Log into your Stripe dashboard and navigate to Developers > API keys. Copy your Secret key — this is what Pipeworks uses to connect to your account.

For testing, use the key that starts with sk_test_. For production, use the key starting with sk_live_.

Open your Pipeworks console

Log into your Pipeworks workspace and go to the Integrations page. Find Stripe in the list and click on it.

Enter your credentials

Paste your Stripe API key into the API Key field and click Connect.

Pipeworks encrypts your key with AES-256-GCM before storing it. The plaintext key is never saved to disk and is only decrypted when your integration container starts.

Start the integration

Click Start to launch the Stripe integration container. This takes a few seconds. Once the status shows Running, your agent is ready to use Stripe tools.

Test the connection

Use the Test button in your Pipeworks console to verify the connection. This sends a simple API call to Stripe to confirm your key works.

What Your Agent Can Do

Once connected, your AI agent has access to Stripe tools for:

Customers — List, create, update, and search customers
Payments — Create payment intents, list charges, process refunds
Subscriptions — Create and manage recurring billing
Products & Prices — Manage your product catalog
Payment Links — Generate shareable payment URLs
Invoices — Create, send, and manage invoices

Tip

Use tool profiles to control what your agent can do. Set the profile to read-only if you only want your agent to retrieve data, not modify anything.

Connecting from Your AI Agent

Add the Pipeworks tools endpoint to your agent's configuration. Here's an example for Claude Desktop:

json

{
  "mcpServers": {
    "pipeworks-stripe": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.pipeworks.ai/tools/stripe"]
    }
  }
}

Claude Desktop will prompt you to sign in through Pipeworks when you first connect. No access key needed.

Troubleshooting

Connection test fails? Double-check that you copied the full API key from Stripe, including the sk_test_ or sk_live_ prefix.

Container won't start? Make sure your integration is enabled. An admin needs to assign the Stripe integration to your workspace first.

Agent can't find tools? Verify your Pipeworks session is authenticated and that the integration status shows "Running" in your Pipeworks console.

Connect Stripe to Pipeworks

Prerequisites