---
name: stripe-projects
description: Stripe Projects is a CLI for provisioning software stacks.
---

# stripe-projects

Stripe Projects is a CLI for provisioning software stacks.

# stripe-projectsby stripe
Stripe Projects is a CLI for provisioning software stacks.

`npx skills add https://github.com/stripe/agent-toolkit --skill stripe-projects`Download ZIPGitHub

## Stripe Projects — Service Provisioning

Provision third-party services (databases, auth, hosting, analytics, caching, AI, observability) and retrieve API keys/tokens using the Stripe Projects CLI plugin.

## Workflow

### Step 1: Ensure Stripe CLI + Projects Plugin

Check if the Stripe CLI is available:

```
`which stripe && stripe --version
`
```

If not installed or below version 1.40.0:

* macOS (Homebrew): `brew install stripe/stripe-cli/stripe` (or `brew upgrade stripe/stripe-cli/stripe`)

* Other platforms: Direct the user to https://docs.stripe.com/stripe-cli/install for up-to-date instructions.

Then ensure the Projects plugin is installed:

```
`stripe plugin install projects
`
```

### Step 2: Search the Catalog

Confirm the requested provider/service exists:

```
`stripe projects search <query> --json
`
```

If `result_count` is 0, inform the user the service was not found and stop.

If the user’s request is vague (for example, “I need a database”), browse the catalog to suggest options:

```
`stripe projects catalog --json
`
```

### Step 3: Initialize a Project

Check if a project is already initialized:

```
`stripe projects status --json
`
```

If not initialized:

```
`stripe projects init --yes
`
```

(don’t use ‘–json’ for this command)

If the CLI output indicates a browser was opened for authentication, stop and clearly tell the user to complete sign-in in their browser. Don’t run further commands until they confirm they’re done.

Important: `stripe projects init` installs the `stripe-projects-cli` skill locally at `.claude/skills/stripe-projects-cli`. This skill contains the full post-init command reference.

### Step 4: Hand Off to stripe-projects-cli

Verify the skill was installed:

```
`test -f .claude/skills/stripe-projects-cli/SKILL.md && echo "OK" || echo "MISSING"
`
```

If `MISSING`: re-run `stripe projects init --yes` — the skill is bundled with the Projects plugin and installed during init.

If `OK`: use the locally-installed `stripe-projects-cli` skill (invoke using the Skill tool with name `stripe-projects-cli`) to continue the workflow — adding services, managing credentials, and configuring the project.

### Step 5: Summarize and Suggest

After a successful service addition, provide output in this format:

FieldValueProvider`<provider name>`Service`<service type>`Tier`<tier>`Env vars`<variable names only — never values>`
Then suggest 3–5 complementary services from different categories in the catalog (for example, if user added a database, suggest auth, hosting, or observability). Only reference services that actually appear in `stripe projects catalog --json` output — never fabricate commands or provider names.

## CLI as Source of Truth

The CLI manages all state under `.projects/` and generates `.env` files. Don’t hand-edit these files. If you need to inspect project state, use the appropriate CLI command:

TaskCommandView provisioned services`stripe projects status --json`List env var names`stripe projects env --json`Check project health`stripe projects status --json`Browse available services`stripe projects catalog --json`
Only inspect `.projects/` or `.env` directly if the user explicitly asks you to — the CLI is authoritative, so manual edits may be overwritten.

## Error Handling

Error codeCauseRecovery`PROVIDER_NOT_LINKED`Provider requires OAuth linkingRun `stripe projects link <provider>` — this may open a browser`UNKNOWN_ERROR`Unexpected failureShow the full error message to the user and suggest running with `--debug` for diagnosticsService not in catalogQuery returned 0 resultsInform user; suggest `stripe projects catalog --json` to browse alternativesCLI not foundStripe CLI not installedInstall using Homebrew (macOS) or follow https://docs.stripe.com/stripe-cli/install

## More skills from stripe
stripe-best-practicesby stripeLatest Stripe API version: 2026-04-22.dahlia . Always use the latest API version and SDK unless the user specifies otherwise.upgrade-stripeby stripeGuide for upgrading Stripe API versions and SDKsstripe-best-practicesby stripeDecision guide for Stripe API selection, Connect setup, billing, and integration patterns. Routes integration decisions across six domains: one-time payments (Checkout Sessions), custom payment forms (Payment Element), saved payment methods (Setup Intents), marketplaces (Accounts v2), subscriptions (Billing APIs), and embedded financial accounts (Treasury) Provides reference documentation for each integration type, including API version guidance (latest: 2026-02-25.clover) and pre-launch...stripe-projectsby stripeProvision third-party services and retrieve API keys/tokens using the Stripe Projects CLI plugin.create-payment-credentialby stripeUse Link to get secure, one-time-use payment credentials from a Link wallet to complete purchases.pay-for-http-requestby stripeMake HTTP requests with automatic x402 payment support using the purl command line interface.

---

**Source**: https://github.com/stripe/agent-toolkit/tree/HEAD/skills/stripe-projects
**Author**: stripe
**Discovered via**: mcpservers.org