OverviewHow It WorksQuickstartGlossaryCourse Creation GuideCourse SchemaBrand SchemaReview GateDesign GuideCLI ReferenceMCP ServerKnowledge GraphMastery LearningAdaptive DiagnosticsSpaced RepetitionTask SelectionGamificationLearning StaircaseBilling

Billing

Graspful is free to use for course creation. You only pay when learners pay. The platform takes a 30% fee and you keep 70%.

Revenue share model

Every paid course on Graspful uses a 70/30 revenue split.

70%
You keep

Direct deposit to your Stripe Connect account

30%
Platform fee

Covers hosting, adaptive engine, billing infrastructure

Example: A learner pays $29/month for your AWS prep course. You receive $20.30 and Graspful retains $8.70. Payouts happen automatically via Stripe Connect.

How money flows

1

Learner subscribes

A learner visits your brand's site and subscribes via Stripe Checkout. The charge goes to the Graspful Stripe account.

2

Platform processes payment

Stripe processes the payment. Graspful's 30% platform fee is deducted automatically.

3

Your share is transferred

The remaining 70% is transferred to your connected Stripe account. Standard Stripe payout schedules apply (typically 2 business days).

4

You get paid

Stripe deposits your earnings into your bank account on the regular payout schedule.

Stripe Connect setup

To receive payouts, connect your Stripe account to your Graspful organization.

  1. Go to your organization settings in the Graspful dashboard.
  2. Click Connect Stripe. This redirects you to Stripe's onboarding flow.
  3. Complete Stripe's identity and banking verification.
  4. Once connected, your organization shows a connected status. Payouts begin automatically on the next billing cycle.

Note: You can publish free courses without Stripe Connect. Stripe is only required when you want to charge learners.

Free tier

The following are always free, with no usage limits:

  • Creating and scaffolding courses (CLI + MCP)
  • Filling concepts with content
  • Running review quality checks
  • Validating YAML schemas
  • Importing courses as drafts
  • Describing and inspecting course statistics
  • Creating and importing brands
  • Publishing free courses (set pricing.monthly: 0 in the brand YAML)

You only start paying the 30% platform fee when learners pay you. If your course is free, Graspful is free.

API key management

API keys authenticate CLI and MCP operations that interact with the Graspful platform (import, publish, list courses).

Creating an API key

Create API keys in your organization settings or via the API:

# Via the API
curl -X POST https://api.graspful.com/api/v1/orgs/my-org/api-keys \
  -H "Authorization: Bearer <your-jwt>" \
  -H "Content-Type: application/json" \
  -d '{"name": "CI Pipeline"}'

Using API keys

Pass the API key to the CLI via login, or to the MCP server via environment variable:

# CLI: save credentials
graspful login --token gsk_your_key_here

# MCP: set environment variable
export GRASPFUL_API_KEY=gsk_your_key_here

Security: API keys have full access to your organization. Never commit them to version control. Use environment variables or secret managers in CI.

API endpoints

The billing-related API endpoints. All require authentication.

POST/api/v1/orgs/:orgId/api-keys
POST/api/v1/brands
PATCH/api/v1/brands/:slug
POST/api/v1/orgs/:orgId/courses/import
POST/api/v1/orgs/:orgId/courses/:courseId/publish