Creed
Creed

Docs

What Creed is, what goes in it, how to connect your agents, how they read and improve it, and the full tool and API reference.

On this page
OverviewHow it worksWhat goes in a CreedGraph Tags and Nexus
On this page
OverviewHow it worksWhat goes in a CreedGraph Tags and Nexus

What Creed is

Creed is your personal context profile. One file that captures who you are: values, goals, work, preferences, constraints, people, health, routines. Any AI you talk to knows you instantly instead of starting from zero every conversation.

It is not a journal, scratchpad, or chat log. The value comes from keeping the profile concise, current, and specific enough that every section actually changes how AI replies to you.

It works the same whether you write code all day or never touch a terminal. The structure is identical for everyone; only the examples shift to match how you work.

How Creed works

Creed runs on a simple loop: you write yourself down once, connected agents read that file before they answer you, and they propose small updates as they learn. You approve the good ones and the profile sharpens over time.

1
Write it once

Onboarding turns a few answers into a first draft. You shape it into a profile you would be happy to read out loud.

2
Agents read it

Every connected agent reads your Creed before it answers, so it starts knowing your role, goals, and preferences instead of guessing.

3
Agents propose

As an agent learns something durable about you, it proposes a small, focused update to the right section.

4
You approve

You accept the good proposals and skip the rest. The profile sharpens over time without you maintaining it by hand.

You stay in control of every change. Trusted agents can be granted direct-edit access per section; everything else stays a proposal you approve.

What goes in a Creed

A Creed has ten sections: five always-on core sections everyone fills in, and five optional ones that appear only once you use them. The whole thing is plain Markdown, sized to read end to end in under a minute.

Aim for specific over complete. A short profile that changes how AI replies beats a long one that reads like a resume.

Always on
Identity

Role, defining traits, values, and the defaults that follow you everywhere.

Goals

Live priorities, near-term outcomes and longer-horizon aims.

Work

What you do, the tools you reach for, and how you like to work.

Preferences

Reply-style defaults with concrete do and avoid signals.

Routines

Daily, weekly, and seasonal rhythms AI should respect.

Optional, appears once used
Beliefs

Stable values and worldview that change how AI reasons or recommends.

Constraints

Hard noes, sensitive topics, and actions that need explicit permission.

People

Named relationships AI should remember and treat consistently.

Health

Conditions, accessibility needs, and dietary patterns to accommodate.

Context

Durable catch-all: location, life stage, environment, background facts.

creed.md
## Identity
Product designer turned solo founder. I value clarity over cleverness
and ship small, polished things. Default to plain language; I dislike jargon.

## Goals
- Launch the v1 private beta by the end of Q3.
- Reach 1,000 weekly active users before raising.

## Preferences
- Lead with the answer, then the reasoning. Skip "great question" preambles.
- Push back when I'm wrong instead of agreeing politely.

## Routines
- Deep-work mornings, 8 to 12, no calls. Schedule meetings after lunch.
- Sleep 11pm to 7am. Don't suggest tasks past 10pm.

Graph Tags and Nexus

Graph Tags are section references. They tell agents which other sections are nearby context, and they power Nexus, the graph view in the file header.

Typing # in the editor opens a section picker. It becomes a styled chip only when it matches a real visible section, case-insensitively. If it does not match a section, it stays plain hashtag text.

Use a short Graph Tags subsection near the end of each section when it helps. Two to four related sections is usually enough. Do not use Graph Tags for tools, apps, brands, themes, clients, or random labels unless those are actual section names.

Nexus is read-only in v1. It shows visible sections as draggable nodes, colours each node with the section accent, draws tethers from valid section references, ignores fake tags, and shows the section name plus quality score on hover.

Company Creed

The Company plan adds one shared Company Creed on top of your personal one. It is the same structured file, owned by the team instead of a person, so every member's agents read the same company context before they act: how the team works, what it is building, the conventions and constraints that apply to everyone.

Members switch between their personal Creed and any Company Creed they belong to from the workspace dropdown. Roles decide what each person and their agents can do. Owners manage billing and members, admins manage members and content, and members read and propose. Section permissions can loosen or tighten who edits what, and every change is attributed and visible in the team activity view.

Billing is per workspace and owner-only. The Company plan is $129 per month, $999 per year, or $1,999 one-time for lifetime, and each includes 10 seats. Extra seats are $12 per month, $99 per year, or $199 one-time. Every Company plan supports BYOK, and the shared usage allowance is $50 per month (a one-time credit on lifetime).

  • Buy from the pricing page. You do not need a personal Creed first, only a Creed account.
  • Invite members by email. They join a seat, connect their own agents over MCP, and read the shared Company Creed.
  • Roles: Owner (billing, members, content), Admin (members, content), Member (read and propose).
  • Section permissions control who can edit each section directly versus by proposal.
  • The activity view shows reads, proposals, and edits across every member and agent.

Connecting over MCP

Creed MCP uses OAuth, so there is nothing to copy. You add the Creed server URL to your agent as a custom MCP connector; the agent opens a browser, you click Allow on the Creed consent screen while signed in to creed.md, and it stays connected. The exact URL is on your Connections page (https://creed.md/mcp on the hosted app).

After connecting, the agent reads Creed once to confirm access, then reads it before meaningful work and proposes narrow updates as it learns. You should not need a second setup prompt.

  • Connect from the Connections page: copy the server URL, or use the per-agent command or one-click button.
  • The first time the agent calls Creed it runs the OAuth flow and opens a browser. Approve while signed in to creed.md. Tokens refresh automatically after that.
  • Verify by listing the MCP tools and calling read_creed once. Do not claim connected unless read_creed succeeds.
  • Update sections with the flat creed_* tools. The server applies the edit directly or as a proposal based on each section's permission; get_write_policy reports what's allowed.
  • If anything is unclear during setup, read https://creed.md/docs once and follow it.

Per-client steps

Every MCP client connects from the same server URL. These are the per-client steps; each one ends with a browser approval.

  • Claude Code: run claude mcp add -t http creed https://creed.md/mcp, then /mcp to authorize in the browser.
  • Codex: run codex mcp add creed --url https://creed.md/mcp, then codex mcp login creed to authorize.
  • Cursor: use the one-click Add MCP button on the Connections page, then authorize in the browser.
  • OpenCode: add Creed to opencode.json as a remote server (type remote, the server URL), then run opencode mcp auth creed to authorize.
  • ChatGPT and other MCP chatbots: add a custom connector with the server URL and approve in the browser.
  • Any other MCP client: add the server URL as a custom or remote MCP server and approve when prompted. Non-MCP clients can fall back to the HTTP read API.

Troubleshooting the connection

Almost every connection issue is the OAuth step. These cover the common ones.

  • No browser popup: re-run the agent's connect or auth action (/mcp in Claude Code, codex mcp login creed, opencode mcp auth creed). It opens your default browser.
  • Stuck on sign-in: authorize while signed in to creed.md in that browser. Signed out, the consent screen signs you in first, then returns to Allow.
  • 401 or 'unauthorized' from the MCP endpoint: the client isn't authorized yet or the token expired. Reconnect or re-run the auth step to get a fresh token.
  • An old connection stopped working: Creed moved from static tokens to OAuth. Remove the old server entry, re-add it by URL, and authorize again.
  • Registration fails on connect: make sure the client supports OAuth-based remote MCP (Claude, Cursor, Codex, OpenCode, ChatGPT connectors all do).
  • You must have an active, set-up Creed to authorize. Finish onboarding first if the consent screen asks you to.

Chatbots

Connect Creed to the assistants you chat with. Each one reads your profile before it answers and can propose updates you approve.

Claude

Add Creed as a connector in Claude. It reads your profile before replying and proposes refinements as it learns about you.

ChatGPT

Add Creed as a connector. ChatGPT picks up your context at the start of a chat and can suggest updates you approve in Creed.

Grok

Connect Creed in Grok so it starts every chat with your context and suggests refinements as it learns.

Whirl

Connect Creed in Whirl so it answers with your context from the first message and proposes updates over time.

Assistant agents

Long-running assistants can keep your profile current on their own. Point them at Creed and let them review it on a cadence you trust.

OpenClaw

Set up a recurring background task that re-reads your profile, compares it against recent conversations, and proposes only durable refinements.

Hermes

Keep Creed in a stable bootstrap path and use scheduled scripts to revisit durable context on a cadence you trust.

Coding agents

Coding agents read Creed before they plan or write, so they match your stack, your conventions, and how you like to work.

Claude Code

Connect with one claude mcp add command, then /mcp to authorize. Pair it with a recurring reminder to revisit the profile after meaningful work.

Codex

Add Creed with codex mcp add, then codex mcp login. Schedule a periodic review that proposes tightening when goals or preferences shift.

OpenCode

Add Creed as a remote server in opencode.json, then opencode mcp auth creed. Reference it from your bootstrap instructions to keep it current.

Cursor

Use the one-click Add MCP button on Connections, then authorize. Creed shapes Cursor's answers around how you actually work.

Custom agents

Anything that speaks MCP connects from the server URL over OAuth. Clients that can't speak MCP use the HTTP API instead.

Custom agent

Build recurring profile review into your own workflow with cron, queues, or whatever your stack already uses.

How AI should use Creed

Connected agents read Creed before answering you, let it shape how they reply, and propose narrow updates as they learn new things about you. You approve the good ones and the profile sharpens over time.

  • Read the visible profile before answering, planning, recommending, or scheduling anything.
  • Anchor tone, defaults, and assumptions to what the profile already says about you.
  • Respect constraints and routines without being asked to repeat them.
  • When something new is learned about the user, propose a small focused update to the right section.
  • Keep the profile concise. Propose tightening or pruning when a section is stale or bloated.
  • Never use Creed as a session log, mood tracker, or place for things only true today.

Set this up from Connections, then review proposed updates from the file view.

When to propose

Propose an update when you learn something durable about the user, something that would change how a future AI should reply to them, not just a one-time mood or task. The test is: would this make every next AI conversation better?

Most bad proposals are not wrong, they are noisy. If something does not change how a future AI should treat the user, it should not be in the profile.

Propose
  • Propose new identity facts, values, or defaults that should follow the user across every AI.
  • Propose preference changes when the user clearly signals a new style they want by default.
  • Propose Goals updates when a near-term outcome shifts or completes. Keep them concrete and current.
  • Propose Routines, People, or Health updates when AI should account for them in future replies.
  • Propose tightening or removing a section when it has gone stale, vague, or contradicted itself.
Don't propose
  • Do not propose session summaries, mood updates, or diary-style entries.
  • Do not propose generic personality praise (curious, driven, thoughtful) without a concrete anchor.
  • Do not propose one-off task instructions or things only true for the next hour.
  • Do not ask the user what to add. Either propose something durable or do nothing.

How each section works

Each section captures a different kind of context about the user. Good agents aim updates at the section that best matches what they learned instead of dumping everything into one bucket.

Identity

What belongs
  • Concrete role, defining traits, values, and defaults that make the user distinct.
  • Anchors AI should hang every reply on: voice, taste, what they care about.
What to avoid
  • Bio-style life history.
  • Generic personality words without a real example behind them.

Beliefs

What belongs
  • Stable values or worldview that should change how AI reasons or recommends.
  • Convictions that explain why the user prefers certain trade-offs.
What to avoid
  • Platitudes or motivational quotes.
  • Things the user has not actually committed to.

Goals

What belongs
  • Live priorities: near-term outcomes and longer-horizon aims.
  • Concrete targets with stale-by hints when timing matters.
What to avoid
  • Vague intentions like 'grow' or 'be better'.
  • Goals that shipped or were abandoned without being updated.

Work

What belongs
  • What the user does, the tools and stack they use, and how they like to work.
  • Real surfaces, methods, collaborators, and craft details AI should know.
What to avoid
  • Exhaustive resume-style history.
  • One-off project notes that belong in Goals or Context.

Preferences

What belongs
  • Specific reply-style defaults: length, tone, formatting, follow-up behavior.
  • Concrete do/avoid rules AI should apply by default.
What to avoid
  • Generic 'be helpful' or 'be honest' filler.
  • Momentary tone requests from one chat.

Constraints

What belongs
  • Hard noes, sensitive topics, and actions that need explicit permission.
  • Lines AI should not cross even if the user seems to ask in the moment.
What to avoid
  • Temporary dislikes.
  • Vague fears that do not give AI a concrete rule.

People

What belongs
  • Named relationships: who they are, why they matter, what AI should remember.
  • Family, partners, collaborators, and pets that come up in conversation.
What to avoid
  • Casual mentions of strangers.
  • Sensitive details the user has not explicitly chosen to share.

Health

What belongs
  • Conditions, sensitivities, dietary patterns, and accessibility needs, paired with how AI should accommodate them.
  • Durable physical or mental health context that should shape suggestions.
What to avoid
  • One-off symptoms or short-term illnesses.
  • Diagnoses without any guidance for how AI should respond.

Routines

What belongs
  • Daily, weekly, and seasonal rhythms AI should respect when planning or scheduling.
  • Working hours, sleep windows, deep-work blocks, recurring commitments.
What to avoid
  • Today's todo list.
  • Routines the user has clearly stopped following.

Context

What belongs
  • Durable catch-all details that don't fit elsewhere: location, life stage, environment.
  • Background facts AI should know but that aren't preferences, goals, or constraints.
What to avoid
  • Mood updates or session recap.
  • Long open-question lists that belong in your own notes.

Good and bad proposal examples

Examples are often more useful than abstract rules. These are the kinds of updates Creed should accept and the kinds it should keep out.

Goals

Good
  • +Ship Creed v1 to public launch by end of June; current focus is onboarding polish.
  • +Move to Lisbon in Q4. Researching neighborhoods and visa paths now.
Bad
  • −Be more productive this year.
  • −Worked on the landing page for three hours today.

Preferences

Good
  • +Default to concise replies. No preamble, no recap of what I just said.
  • +Push back when I'm wrong instead of agreeing politely.
Bad
  • −Be helpful and friendly.
  • −Use a professional tone unless I say otherwise today.

Routines

Good
  • +Deep-work mornings 8 to 12, no calls. Schedule meetings after lunch.
  • +Sleep window 11pm–7am, don't suggest tasks past 10pm.
Bad
  • −Tries to be productive every day.
  • −Started a new gym schedule this week, will see how it goes.

Health

Good
  • +Lactose intolerant. Suggest dairy-free alternatives in any recipe.
  • +ADHD. Break long plans into short steps and surface one next action at a time.
Bad
  • −Generally healthy.
  • −Had a headache this afternoon.

People

Good
  • +Maya: partner, designer, prefers we make travel decisions together.
  • +Jonas: co-founder, handles ops, default to him for legal and finance questions.
Bad
  • −Met someone interesting at a conference last week.
  • −Friend group is great.

Keeping your profile current

When you finish helping the user with something real, ask: did I learn something durable about them? Did anything in the profile look stale or wrong? Only then decide whether to propose an update.

  • Ask whether you learned something durable enough to help every future AI conversation.
  • Check whether any section now reads as stale, vague, duplicated, or contradicted.
  • Prefer one sharp refinement or prune over several loose additions.
  • If yes, propose it proactively without asking what to propose.
  • If no, do nothing and leave Creed unchanged.
  • If you spot a problem in the profile itself, propose the fix and flag it clearly.

On a recurring cadence

The best Creed setups also revisit the file on a cadence. A small recurring review compares the profile with what's actually true now, sharpens what belongs, and prunes what's gone stale.

Recurring maintenance should improve quality, not volume. The goal is to keep the profile concise and current.

  • Run a recurring check when an agent has enough autonomy to review the profile without micromanagement.
  • Look for goals that shipped, routines that changed, or context that no longer fits.
  • Tighten generic phrasing into concrete defaults grounded in real examples.
  • Prefer pruning and merging over constant appending.
  • If nothing has changed, do nothing.

Per-section permissions

Each section sets its own agent permission, so you can keep part of your profile reference-only and let agents maintain the rest. The mechanics differ per section, but the standard stays the same: only durable, profile-worthy context belongs in the file.

  • Propose is the default reviewed path. Agents suggest updates and you decide what enters the section.
  • Direct lets a trusted agent edit that section immediately, with the same restraint it would bring to a proposal.
  • Read-only keeps a section visible to agents for context but blocks edits and proposals.
  • Hidden removes a section from the agent's view entirely, so it never reaches a connected tool.
  • Permissions are per-section and enforced on the server. The bar for what belongs does not move.

How Creed measures quality

Creed can score how good your profile is, section by section, and surface where to sharpen it. Quality analysis runs on a monthly AI allowance included with your plan, with prepaid top-ups when you need more, or on your own OpenRouter key at cost.

It judges how context is written, never what it is about. A section on work and a section on LEGO are held to the same bar. The only question is whether it helps the next AI know you better.

The five tests
Specific

Names real things: tools, people, numbers, dates, defaults. Not language anyone could have written.

Anchored

Claims carry an example, a rule, or a consequence, so AI knows how to act, not just what is true.

Steering

It would actually change how AI replies. The most important test.

Current

Nothing stale, abandoned, or self-contradicting.

Tight

No padding or repetition. Every line earns its place.

The overall score is computed from the sections, not asked of the model, so the headline never drifts from what it summarizes.

  • The five core sections are the backbone. A flawless core alone tops out around 90.
  • Every well-written optional or custom section lifts the score toward 100, with diminishing returns.
  • A weak optional section never drags the total down. Trying new context is never punished.
  • If a core section is nearly empty, the whole file is capped at 70.

MCP tools, prompts, and resources

Once connected, an agent has a focused set of tools for reading and improving your Creed. The flat creed_ tools are the recommended path: each one applies your change directly when that section allows direct edits, or files it as a proposal when approval is on. You never pick the mode; the server does, and every call reports what happened.

Read and inspect

read_creed

Read the full profile plus the private agent contract.

list_sections

List sections with their ids, names, and accents.

creed_get_section

Fetch one section by id or name, with its content and metadata.

creed_search

Find where a fact lives without reading the whole profile.

creed_get_recent_activity

See recent changes so agents avoid duplicate proposals.

creed_get_quality_report

Read the latest quality report to target the weakest sections.

get_write_policy

Check the current write mode and what edits are allowed.

Edit content

creed_update_section

Replace a section's body. Params: sectionId, contentMarkdown.

creed_append_to_section

Add to a section without rewriting it. Params: sectionId, contentMarkdown.

Manage sections

creed_create_section

Add a new section. Params: name, contentMarkdown, optional accent.

creed_delete_section

Remove a section. Params: sectionId.

creed_rename_section

Rename a section. Params: sectionId, name.

creed_recolor_section

Change a section's accent. Params: sectionId, accent.

creed_reorder_section

Move a section. Params: sectionId, then afterSectionId or position.

Two lower-level tools sit underneath these: propose_creed_update submits a proposal in any mode, and direct_edit_creed applies a change immediately where a section allows it (it stays hidden until at least one section is set to direct edit). The flat tools above are built on them and are easier to call correctly.

Prompts and resources

Promptintroduce-me

Read my Creed and introduce me the way a sharp collaborator would.

Prompttighten-my-creed

Review my Creed and propose tightening or pruning where it has drifted.

Resourcecreed://profile

Your current profile, exposed as a readable MCP resource.

When a client connects, the server also sends an instructions field carrying the read-before-work, propose-narrowly contract, so agents behave correctly without you pasting a setup prompt.

HTTP API

MCP is the supported way to connect, and it handles authorization for you. For clients that can't speak MCP, the same capabilities are available over a small HTTP API. Each request sends a bearer token in the Authorization header.

GET/api/creed

Read the profile. Returns the visible Markdown plus the hidden agent contract as plain text. Up to 120 requests per minute.

POST/api/creed/proposals

Submit a proposal. JSON body with the target section, draft, and reason. Works in every mode. Up to 60 per minute.

POST/api/creed/write

Apply a direct edit. JSON body with an operation and its payload. Succeeds only for sections set to direct edit. Up to 60 per minute.

Your data and privacy

Creed is built so the file stays yours: portable, encrypted, and only ever visible to you.

  • One file, plain Markdown. It stays portable, and you can push or pull it to your own GitHub repo from Settings.
  • Your call on AI spend. AI features run on a monthly allowance of prepaid credits, or on your own OpenRouter key. Your context is only ever sent to the model to run the feature you asked for.
  • Secrets are encrypted. API keys and connection tokens are stored with AES-256-GCM, never in plain text.
  • You only ever see your own data. Every table is row-level secured per user.
  • Hidden sections never leave the app. Set a section to hidden and it is dropped from the agent payload entirely.
  • Deletion means deletion. Removing your file or your account wipes the data.

Read the full privacy policy for the complete picture.

Creed

Personal context for your agents.

Fully operational
Product
PricingCompanyExamplesRoadmap
Resources
DocsLearnContextChangelog
Legal
PrivacyTermsStackContact
© 2026 Creed·byhpbrn