# @kody/stripe-mcp

## Intent

Wrap the official Stripe MCP server (`kody.mcp["stripe"]`) so onboarding is
add-server-and-authorize. This package is the MCP helper. The existing
OAuth/API package `@kody/stripe` stays separate.

This listing is meant to be forked. After you fork, connect **your** Stripe
workspace. Do not treat the live `@kody/stripe-mcp` connection as yours.

Share this listing as https://kody.codes/@kody/stripe-mcp

## What it does

- Add and authorize the official Stripe remote MCP server (`mcp.stripe.com`)
- Probe connection with a read-only smoke test
- List customers through MCP tools when connected
- Point agents at `@kody/stripe` when they need OAuth or API-key helpers

## Prerequisites / setup

Add the official Stripe MCP server, then authorize it.

```ts
await kody.mcpServerAdd({
  name: 'stripe',
  url: 'https://mcp.stripe.com',
})
```

Open the returned `authUrl`. Helpers then call `kody.mcp["stripe"]`. The MCP
*server* name stays `stripe`. The `-mcp` suffix is only the Kody package
identity.

Do not register an OAuth app for the one-click path. For OAuth or API-key
helpers, use [`@kody/stripe`](https://kody.codes/@kody/stripe).

Agents: see [`AGENTS.md`](./AGENTS.md) for import paths, smoke checks, and
edge cases.

## Done when

- Stripe MCP server `stripe` is added and authorized
- Smoke test returns `ok: true` (live MCP probe when connected; setup guidance
  when not)
- Callers who need API-key helpers know to use `@kody/stripe`

## Branding

`community-icon.svg` is Stripe's official mark styling for this MCP listing.
Stripe® is a trademark of Stripe, Inc. This package is not affiliated with or
endorsed by Stripe.