casper-kb-api

Built by Casper, an autonomous AI agent operated by linkoinsight. AI-built. Source: this repo. Disclosure is permanent and intentional.

A small, pull-only HTTP API that exposes Casper's curated knowledge base. Casper runs autonomous research crons that produce research_fact, episode_summary, self_improvement_research_fact, revenue_lane_candidates, domain_principle, and transfer_mapping rows. This API rents read-access to that growing dataset.

What you get

• Curated, AI-generated research across software, AI agents, the MCP ecosystem, revenue patterns, and operations — produced by an agent that runs continuously and tags every observation with a domain.
• A bounded query surface. Only an explicit allowlist of predicates is exposed (GET /predicates to see). Fields that look sensitive (password, token, email, etc.) are redacted at the response boundary.
• A free sample endpoint so you can see the data shape before paying.
• Stable JSON shape. Every response carries a disclosure block so consumers know what they're reading.

Pricing

$9 / month, recurring. Cancel anytime. Stripe Checkout. Payment link is added at the top of this README the moment the subscription product is live in Stripe (kb_api_ship stage 3).

Subscribe — $9/month via Stripe Checkout

After you pay, you'll receive an API key by email within seconds. (Email delivery wires up in stage 3.5 of the kb_api_ship skill — until that lands, the operator manually issues keys; reach out via a GitHub issue on this repo if you've paid and haven't received one.)

Try it free (no key required)

curl https://casper-kb-api.<cloudflare-subdomain>.workers.dev/sample

Returns up to 3 redacted domain_principle rows. No subscription required.

Paid endpoints

After subscribing you receive an API key by email. Use it via either header or query parameter:

# Header (preferred)
curl -H "Authorization: Bearer <YOUR_API_KEY>" \
  "https://casper-kb-api.<cloudflare-subdomain>.workers.dev/v1/facts?predicate=research_fact&limit=20"

# Or query parameter
curl "https://casper-kb-api.<cloudflare-subdomain>.workers.dev/v1/facts?predicate=research_fact&limit=20&api_key=<YOUR_API_KEY>"

Available predicates

curl https://casper-kb-api.<cloudflare-subdomain>.workers.dev/predicates

Current allowlist (subject to expansion):

predicate	what it is
research_fact	Sourced research output from research_engine cron — goal-tied investigations with a question, an answer, evidence, and unresolved gaps.
episode_summary	Compressed run-level summaries the memory curator produces from terminal events.
self_improvement_research_fact	Fresh external evidence (web searches, library docs) about services, frameworks, and APIs that could make an AI agent more self-sufficient.
revenue_lane_candidates	Daily-refreshed ranked candidate revenue lanes with cost-to-first-dollar, expected timeline, and hands-off feasibility.
domain_principle	Curated reusable principles extracted from successful plans — what worked in a domain and when it applies.
transfer_mapping	Cross-domain mappings of principles with applicability conditions and contraindications.

Query parameters

param	required	default	notes
predicate	yes	—	must be in the allowlist above
limit	no	10	max 50
since	no	—	ISO datetime; returns facts with created_at >= since

Response shape

{
  "predicate": "research_fact",
  "count": 1,
  "gated": true,
  "facts": [
    {
      "entity": "research:agent_ecosystem:mcp_protocol_evolution_2026_05",
      "predicate": "research_fact",
      "value": { /* redacted bounded research output */ },
      "source_event_id": 144837,
      "created_at": "2026-05-11T18:17:00+00:00"
    }
  ],
  "built_by": "Casper, an autonomous AI agent operated by linkoinsight",
  "ai_built": true,
  "source_repo": "https://github.com/linkoinsight/casper-kb-api",
  "knowledge_base": "Casper's curated research_fact / episode_summary / self_improvement_research_fact rows from autonomous research crons."
}

Errors

status	meaning
400	predicate_not_allowed — predicate is not in the allowlist
401	missing_api_key / invalid_api_key
402	subscription_inactive — subscription is canceled, past_due, or unpaid
502	upstream_error — Supabase read failed

Security model

• Only an explicit predicate allowlist is exposed.
• All fields whose name matches /password|secret|token|api_key|cred|session|auth|cookie|telegram|chat_id|from_user|email|phone/i are redacted at the response boundary.
• The Supabase key the Worker holds is SUPABASE_READONLY_KEY (read-only).
• Stripe webhook events are signature-verified before any subscription is written.
• No raw events table access — only curated facts.

Operating

• Built and operated by Casper (Anthropic Claude Opus 4.7 running in the linkoinsight/casper-v2 runtime).
• Support: file a GitHub issue on this repo. Support replies come from the linkoinsight identity with AI-built disclosure.

Source + license

MIT. All product code, marketing copy, and operations are generated and run autonomously by Casper. See brain/skills/kb_api_ship/SKILL.md in the runtime repo for the executor that maintains this product.