Your agents turn specs, transcripts, and brainstorms into rich, structured docs — canvases, boards, timelines — that compound into one company knowledge base every agent can read over MCP.
One authored block. The board your team reads is the typed graph your agents read over MCP.
Every surface renders for your team — and is read by your agents over MCP.
One surface
Everything your company needs to document, in one place.
Product docs and architecture, the sales pipeline and runbooks, decisions, onboarding, OKRs, the org — every kind of company knowledge, authored as MDX in your repo and live below. Each surface renders for your team and serializes for your agents.
Shipped the MCP search ranking; reviewing the canvas serializer PR.
—
Dev Patel
DevOps
Migrated CI to the new runner; preview deploys are 2x faster.
Waiting on prod secrets rotation
Ren Ito
Frontend
Landed the dual-rep table; starting on the org-chart canvas tile.
—
John
QA
Wrote smoke suite for the redirect path; all green on staging.
—
okrs.mdxReadable by agents
OKRs
Loading canvas…
brand.mdxReadable by agents
Brand
Accent
Accent weak
Ink
Display
Inter · 680
Body
Inter · 400
Code
JetBrains Mono · 400
One corpus. Humans and agents.
journey.mdxReadable by agents
User journey
Loading canvas…
launch.mdxReadable by agents
Launch checklist
Release checklist
2 / 4 done
Ship
Cut release branchMaya
Run smoke suiteDev
Update changelogRen
Comms
Announce in #releases
onboarding.mdxReadable by agents
Onboarding
Evaluating
2
Managed (SQS)
Self-host (Redis)
Decided
1
Chosen: SQS
org.mdxReadable by agents
Org chart
Loading canvas…
team.mdxReadable by agents
Team roster
MC
Maya Chen
2 reports
Eng lead
platform
DP
Dev Patel
Backend
RI
Ren Ito
Frontend
brainstorm.mdxReadable by agents
Brainstorm
Loading canvas…
runbook.mdxReadable by agents
Runbook
On-call signals
Signal
Sev
First action
5xx > 1%
P1
Page on-call
p99 > 800ms
P2
Check cart svc
Queue depth ↑
P3
Scale workers
Escalation
After two failed retries, page the platform lead.
Why superlore
Documentation broke the day AI started writing it.
Half your docs are read by agents now, not people. Every other tool just bolts an MCP onto the old way of writing them. superlore rethinks the document itself — for a world where AI writes, reads, and maintains it.
Krishnan S G
Creator of superlore
“
For years, every project started at a whiteboard— FigJam, Excalidraw, a wall and a marker. I'd plan the whole shape of a thing before a line of code; the board was the understanding.
Then Claude started shipping whole tickets end-to-end — brilliant at it. But ask for the spec and you get a flawless wall of Markdown: flat, and only as useful as you have time to read. The thinking that lived on the whiteboard flattened with it.
So I built superlore and moved the whole company in — engineering, product, roadmaps, sales, every meeting transcript — into one knowledge base: every brainstorm on a canvas inside the doc, the whole context one MCP call away. Now Claude doesn't show up like an intern you re-brief every morning — it pulls that context and works like an employee who's been here for years.
Agent-native, not retrofitted
AI writes, reads, and maintains your docs now. superlore is built for that first — and still beautiful for the people who read it.
Whiteboards, inside the doc
Brainstorms live as structured data — exact nodes, edges, and relations an agent can query, not a flat image. The board is the graph.
One corpus, shared context
Every team's knowledge in one place, one MCP call from any agent. The company's shared memory — not fifteen scattered wikis.
The shift
The whole industry is describing the same gap.
The people building this era keep circling one idea from different angles — your knowledge has to be readable by machines, not just people. They're naming the problem. superlore is the answer.
Everyone's circling the same idea: your knowledge has to be readable by machines, not just people. That's the whole point of superlore.
Quotes are about the problem space, not endorsements. One card is first-party.
The turn
Give your AI the whiteboard — and the whole doc.
You brainstormed on a whiteboard, closed the tab, and the thinking drifted. Now your AI thinks on the canvas inside the document and shows you — instead of handing back a wall of Markdown to decipher.
architecture.mdxCanvas · rendered
Loading canvas…
superlore turns the wall of Markdown an agent hands back into this live canvas inside your doc — the board your team reads is the typed graph your agents read.
What the agent hands back — a wall of Markdownsuperlore canvas
Dual representation
Every component renders for people and serializes for agents.
Write one MDX block. It becomes a human surface and a clean, typed node/edge graph — no second authoring step, no drift. The board on the left is the graph on the right.
Tighter rate limits at the edge, a cache-first redirect path, and a wider key space. The architecture below is the same typed graph a support agent queries.
Architecture
Loading canvas…
gw · API gateway
Changelog
SecurityPer-key rate limits and stricter auth scopes on /shorten.
FixedReject malformed and duplicate target URLs up front.
ChangedBase62 keyspace widened; retry on key collisions.
Added302s served from cache; sub-millisecond p99 on hot slugs.
AddedCache lookup before the DB, with negative-result caching for unknown slugs.
ChangedLinks partitioned by key prefix for faster reads.
ChangedClick events now emitted async — no redirect-path latency.
Rollout
2024-01
Sign up
Email + password, magic-link optional.
2024-02
Verify email
Confirmation gate before the workspace opens.
2024-03
Set up profile
Name, avatar, role — the minimum to feel real.
2024-04
Invite the team
Seat invites, then the loop closes.
Use case · Product docs & releases
Release notes that show what changed — not just tell.
A release page with a native architecture diagram and a changelog that's an actual timeline. The diagram an engineer reads is the typed graph a support agent queries — from one MDX source, no second authoring step.
Every change is typed(added · changed · fixed · security) so an agent can answer “what shipped in 2.4?” without parsing prose.
The changelog is a real Releases stack, the diagram a real Canvas — both serialize for agents.
This is a live superlore page, not a screenshot.
Use case · Company knowledge base
Your pipeline, decisions, and meetings — one screen your team and your agents can trust.
Capture how the company actually works: every prospect and where it sits, the service that owns sign-up, the digest from last week's sync. The team scans the pipeline board before every planning call; your agent answers from the same typed graph behind it.
Pipeline
A kanban of prospects by stage humans read and agents traverse — not a screenshot.
Entities
Services, owners, SLAs — typed fields and refs, queryable by the MCP.
Meetings
Recorded-meeting digests land as typed rows your team scans in seconds.
One corpus
All MDX in your repo — one source, two faces, no drift.
your-kb.dev/sales/pipeline
MCP
Sales pipeline
Open $1.7M · 19 prospects
The single screen we scan before every planning call — every prospect, its stage, and the next step.
Prospecting
2
Northwind Retail
Intro call booked — map the merchandising data flow first.
~$120K
Vantage Bank
Warm referral; awaiting security questionnaire before discovery.
~$300K
Artifact Ready
2
Atlas Air
Demo dataset + planted anomalies built; sending the artifact this week.
~$180K
Cedar Foods
Tailored deck ready; schedule the walkthrough with ops.
~$95K
Demo
2
Helix Health
Live demo done; following up on the readmissions use case.
~$250K
Meridian Logistics
Second demo for the wider team — bring forecasting scenarios.
~$140K
Pre-PoC
2
Summit Insurance
Scoping the PoC success criteria with their data lead.
~$220K
Brightwave Energy
Negotiating data access + the 6-week PoC plan.
~$160K
PoC
2
Polaris Telecom
PoC live on churn data; mid-point review next Tuesday.
A live superlore page — the same MDX your team reads and your agent queries.
The loop
Write with AI. Review with comments. Hand it back.
The doc is the canvas. Drop comments right on it, Send to agent, and watch the prose and the diagram update together as the thread resolves.
links-api.mdxsuperlore preview
Links API — architecture
Redirects resolve through a cache-first branch: a hit returns the cached target, a miss falls back to the links DB.
Loading canvas…
KrishnanMayaKSMC
Threadon { node: "hit" }Open
KS
Krishnan S G
Tighten this edge label — “yes” reads ambiguous on the cache branch.
MC
Maya Chen
Agreed, and note the miss path writes through to the DB.
Send to agent
The new standard
The new documentation standard, built for agents.
Author once; every agent reads the same structured source over MCP — one URL, the typed graph, not a screenshot. And it renders right in the editor your team already uses, so adopting it is a no-brainer.
Readable by agents
MCP server
/api/mcp
Any agent clientClaude · Cursor · …
One MCP URL/api/mcp
The typed graphnot a screenshot
First-class tools5 over one corpus
search(query)query: string
ranked full-text hits
get_page(path)path: string
a page's structured content
list({ kind, tag }){ kind?, tag? }
nodes by kind / tag
navigate(target)target: string
relations + backlinks
get_component_data(id)id: string
the graph behind a component
MCP server
/api/mcp
Compatible with any agent client — Claude, Cursor, Windsurf — over one MCP URL. The typed graph, not a screenshot.
search
get_page
list
navigate
get_component_data
Lives in your editor
VS CodeCursorWindsurf
One superlore preview extension runs in VS Code — and Cursor and Windsurf are VS Code-compatible forks, so the same extension renders superlore live there too.
Own it
It's MDX in your repo. You own it. Deploy it anywhere.
superlore is open source. Ship it to Vercel, Cloudflare, or your own box — your knowledge stays yours. Scaffold and author it with the superlore skills, preview it in your editor, and deploy when you're ready.
Private and secure when you want it — Google SSO and an org gate flip on from config, and your MCP inherits the same policy.