Skip to content

Commit feb6ed6

Browse files
masnwilliamscursoragent
masnwilliams
and
cursoragent
authored
Add Stripe Projects docs for agent llm_context URLs (#389)
Publish provider- and service-level guides for Stripe Projects provisioning, with redirects from legacy /llm.md paths. Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 276d820 commit feb6ed6

4 files changed

Lines changed: 161 additions & 1 deletion

File tree

‎docs.json‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,9 @@
1414
{ "source": "/browsers/create-a-browser", "destination": "/introduction/create" },
1515
{ "source": "/introduction", "destination": "/" },
1616
{ "source": "/quickstart", "destination": "/" },
17-
{ "source": "/home", "destination": "/" }
17+
{ "source": "/home", "destination": "/" },
18+
{ "source": "/llm.md", "destination": "/integrations/stripe-projects" },
19+
{ "source": "/llm-browser.md", "destination": "/integrations/stripe-projects-browser" }
1820
],
1921
"theme": "palm",
2022
"appearance": {
@@ -216,6 +218,13 @@
216218
"integrations/vercel/marketplace"
217219
]
218220
},
221+
{
222+
"group": "Stripe Projects",
223+
"pages": [
224+
"integrations/stripe-projects",
225+
"integrations/stripe-projects-browser"
226+
]
227+
},
219228
"integrations/1password"
220229
]
221230
},

‎integrations/overview.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ Kernel provides detailed guides for popular agent frameworks:
4040
- **[Magnitude](/integrations/magnitude)** - Vision-focused browser automation framework
4141
- **[Notte](/integrations/notte)** - AI agent framework for browser automation
4242
- **[Val Town](/integrations/valtown)** - Serverless function runtime
43+
- **[Stripe Projects](/integrations/stripe-projects)** - Provision Kernel plans and API keys via the Stripe Projects CLI
4344
- **[Vercel](https://github.com/onkernel/vercel-template)** - Deploy browser automations to Vercel
4445
- **[Web Bot Authentication](/browsers/bot-detection/web-bot-auth)** - Create signed Chrome extensions for web bot authentication
4546
- **[1Password](/integrations/1password)** - Use credentials from your 1Password vaults for Managed Auth

‎integrations/stripe-projects-browser.mdx‎

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: "Stripe Projects — browser API access"
3+
description: "LLM context for the kernel/browser:api-access Stripe Projects service"
4+
---
5+
6+
This page describes the **`kernel/browser:api-access`** deployable service provisioned through Stripe Projects.
7+
8+
## What this resource is
9+
10+
A **project-scoped Kernel API key** used to create and manage cloud browsers (CDP, Playwright, Computer Controls, etc.) for that Stripe Project’s Kernel project.
11+
12+
## Provisioning
13+
14+
```bash
15+
stripe projects add kernel/browser:api-access --config '{"name":"production"}'
16+
stripe projects env --pull
17+
```
18+
19+
### Configuration
20+
21+
| Field | Type | Required | Description |
22+
|-------|------|----------|-------------|
23+
| `name` | string | yes | Label for the API key (e.g. `production`, `staging`) |
24+
25+
## After provisioning
26+
27+
1. Run `stripe projects env --pull` to sync credentials into `.env` / `.projects/vault`.
28+
2. Use the Kernel API key from the environment (typically `KERNEL_API_KEY`) with the SDK or CLI.
29+
30+
```typescript
31+
import Kernel from '@onkernel/sdk';
32+
33+
const kernel = new Kernel(); // uses KERNEL_API_KEY from env
34+
35+
const browser = await kernel.browsers.create();
36+
```
37+
38+
```bash
39+
kernel browsers create
40+
```
41+
42+
## Pricing
43+
44+
| Situation | Price |
45+
|-----------|--------|
46+
| No active Kernel plan on the org | Usage-based: **$0.01/min** (standard), **$0.02/min** (stealth) |
47+
| Active `plan:developer`, `plan:hobbyist`, or `plan:startup` | **Included** with plan (component pricing `free` under parent plan) |
48+
49+
Provision a plan first when the developer needs predictable monthly credits and concurrency limits.
50+
51+
## Operations
52+
53+
```bash
54+
# Rotate credentials (invalidates old key)
55+
stripe projects rotate kernel/browser:api-access
56+
57+
# Remove the resource
58+
stripe projects remove kernel/browser:api-access
59+
```
60+
61+
## Further reading
62+
63+
- [Stripe Projects (provider overview)](/integrations/stripe-projects)
64+
- [Create a browser](https://kernel.sh/docs/introduction/create)
65+
- [API keys](https://kernel.sh/docs/info/api-keys)
66+
- [Projects](https://kernel.sh/docs/info/projects)

‎integrations/stripe-projects.mdx‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
title: "Stripe Projects"
3+
description: "Provision Kernel cloud browsers and plans through the Stripe Projects CLI"
4+
---
5+
6+
Kernel is a Stripe Projects provider. Use the Stripe CLI to link your Kernel account, choose a plan, and provision per-project API keys without using the dashboard for setup.
7+
8+
This page is the provider-level LLM context for agents (`stripe projects llm-context`). Service-specific guidance for cloud browser API keys is in [Stripe Projects — browser API access](/integrations/stripe-projects-browser).
9+
10+
## Service catalog
11+
12+
Stripe service slugs are prefixed with `kernel/` (from the app manifest name).
13+
14+
| Service ID | Kind | Scope | Summary |
15+
|------------|------|-------|---------|
16+
| `kernel/plan:developer` | plan | account | Free tier — $5/mo credits, 5 concurrent browsers |
17+
| `kernel/plan:hobbyist` | plan | account | $30/mo, $10/mo credits, 10 concurrent browsers (email KYC) |
18+
| `kernel/plan:startup` | plan | account | $200/mo, $50/mo credits, 150 concurrent browsers (email KYC) |
19+
| `kernel/browser:api-access` | deployable | project | API key for launching browsers in a Stripe Project |
20+
21+
- Only **one plan** can be active per Kernel org at a time (`allowed_updates` defines upgrade/downgrade paths).
22+
- `browser:api-access` is **free** when any active plan is provisioned; otherwise it is usage-based ($0.01/min standard, $0.02/min stealth).
23+
24+
## Common CLI flows
25+
26+
```bash
27+
# Link Kernel to your Stripe Projects workspace
28+
stripe projects link kernel
29+
30+
# Browse the catalog (confirm exact slugs before provisioning)
31+
stripe projects services list
32+
33+
# Provision a paid plan (requires verified email / KYC)
34+
stripe projects add kernel/plan:hobbyist
35+
stripe projects add kernel/plan:startup
36+
37+
# Provision a project-scoped API key (configuration: {"name": "production"})
38+
stripe projects add kernel/browser:api-access --config '{"name":"production"}'
39+
40+
# Sync credentials into .env
41+
stripe projects env --pull
42+
43+
# Rotate API key credentials
44+
stripe projects rotate kernel/browser:api-access
45+
46+
# Open the Kernel dashboard
47+
stripe projects open kernel --purpose dashboard
48+
```
49+
50+
Run `stripe projects services list` and copy the **exact** service slug from the output before `stripe projects add` — do not guess slugs.
51+
52+
## Account and project mapping
53+
54+
| Stripe | Kernel |
55+
|--------|--------|
56+
| Stripe account | Kernel organization (billing + linking) |
57+
| Stripe Project | Kernel project (API keys, sessions, pools, etc.) |
58+
| Plan resources | Org-wide subscription tier |
59+
| `browser:api-access` | Project-scoped API key |
60+
61+
Each Stripe Project maps 1:1 to a Kernel project within the org. Resources provisioned for a new `project_id` create a Kernel project if needed.
62+
63+
## Authentication
64+
65+
New accounts use the **agentic credentials** flow: after `stripe projects link` / account request, Kernel returns bearer access and refresh tokens. Use `stripe projects env --pull` to load credentials locally.
66+
67+
- **Dashboard (humans):** https://dashboard.onkernel.com
68+
- **Existing Kernel customers** with billing already on file may receive `payment_credentials: "provider"` when linking to avoid double-billing.
69+
70+
## Billing and Shared Payment Tokens (SPT)
71+
72+
Paid plans are charged through Stripe **Shared Payment Tokens** on the Metronome-managed Stripe customer.
73+
74+
<Warning>
75+
The default SPT monthly spending limit is often **$50**. The Start-Up plan is **$200/mo**. Before upgrading to Start-Up, confirm the developer’s SPT limit covers the plan (`stripe projects billing show`) or ask them to raise the limit. Charges above the limit will fail.
76+
</Warning>
77+
78+
## Full documentation
79+
80+
- Doc index for agents: https://kernel.sh/docs/llms.txt
81+
- Create and connect browsers: https://kernel.sh/docs/introduction/create
82+
- API keys: https://kernel.sh/docs/info/api-keys
83+
- Pricing: https://kernel.sh/docs/info/pricing
84+
- Cursor / Claude skills: https://github.com/kernel/skills

0 commit comments

Comments
 (0)