Company Brain
Company Brain

Documentation

Company Brain Guide

Everything you need to build, maintain, and share your company's governed knowledge base.

What is Company Brain?

Company Brain is a governed knowledge engine that aggregates information from your business tools — CRMs, documents, Slack, strategy platforms — and distils it into a single, verified source of fact. That knowledge is then made available to every AI tool your team uses, automatically, via the Model Context Protocol (MCP).

Instead of every employee prompting their AI assistant with background context from scratch, Company Brain loads your company's verified knowledge into every AI session automatically. One setup, continuous benefit.

Connect

Link your tools — CRM, Docs, Slack, strategy platforms — as knowledge sources.

Distil

AI extracts candidates. You review them. Approved ones become verified Facts.

Deliver

Every AI session — Claude, Cursor, ChatGPT — starts with your company context loaded.

Quick Start

Get Company Brain serving context to your AI tools in four steps.

1

Upload your first knowledge

Go to Data Upload and paste a company overview, upload a document (PDF, DOCX, TXT), or connect an integration. Claude AI extracts facts automatically.

2

Review the proposal queue

Extracted facts land in your Review Queue as Proposals. Review each one — press V to verify or D to dismiss. Approved proposals become Facts.

3

Connect your AI tool

Go to MCP Connect, generate an API key, and follow the 3-step setup for your AI client (Claude Desktop, Cursor, Devin Desktop, ChatGPT, and more).

4

Share with your team

Go to Team, generate a company key, and share the setup link. Teammates click it, pick their AI tool, and connect — no Company Brain account needed.

Tip — Enable Brain Agents

Once you have initial Facts, enable Brain Agents to keep your knowledge current automatically. Agents monitor your integrations and propose updates as things change.

Core Concepts

Company Brain is built around five interconnected data types. Understanding how they relate makes the whole system click.

Facts

The canonical facts about your company. Verified by humans, served to AI. Every fact has a category, confidence score, source, and effective date range. Facts are immutable once approved — edits create new versions.

Proposals

Fact candidates awaiting review. Generated by the AI extraction pipeline, autonomous agents, or manual submission. Each proposal shows its confidence score, supporting evidence, and any conflicts with existing Facts.

Evidence

Source excerpts and data points that back up proposals and facts. Every approved Fact carries traceable evidence showing exactly where the fact came from.

Signals

Important observations — market shifts, competitive moves, customer feedback, internal events. Signals don't become Facts directly but inform them. Agents monitor signals and generate proposals when patterns emerge.

Knowledge Workflow

Information flows from raw sources through extraction, human review, and into verified Facts served to AI.

SourceExtractionProposalHuman ReviewFactAI Context

Source — A document, integration, or pasted text. Registered in your sources list with a trust level.

Extraction — Claude AI runs two passes: structured facts (names, numbers, dates) and strategic context (mission, positioning, process). Runs on upload or via agents.

Proposal — Each extracted fact becomes a proposal with a confidence score (0–1). High confidence + no conflicts = auto-approved if you have that setting enabled.

Human Review — Your team reviews proposals in the Review Queue. Approve to create a Fact, dismiss to reject.

Fact — Verified, versioned, categorised. Returned to every connected AI client via MCP tools.

AI Context — When a teammate opens Claude/Cursor/ChatGPT with Company Brain MCP connected, the relevant Facts load automatically.

Conflict Detection

When a new proposal contradicts an existing Fact in the same category, Company Brain flags it as a conflict. You'll see a conflict badge in the Review Queue and the Conflicts section. Resolve by approving one and superseding the other.

Facts

Facts are the atomic unit of knowledge in Company Brain. Each Fact is a single verifiable statement about your company, categorised, confidence-scored, and tied to a source.

Categories

Every Fact belongs to exactly one category, which controls how it's served to AI clients and how conflicts are detected.

CategoryPurposeExample
company_overviewWho you are, your history, founding story"We were founded in 2019 by two ex-Stripe engineers"
mission / visionWhy you exist, where you're going"Our mission is to make company knowledge work for AI"
market / icpYour market, ideal customer profile"Our ICP is Series A SaaS companies with 20–200 employees"
product / featureWhat you build, capabilities"Company Brain supports 8 MCP-compatible AI clients"
pricingPlans, pricing, packaging"Pro plan is $49/month per workspace"
positioning / messagingHow you describe yourself"Governed knowledge layer your AI agents trust"
competitorCompetitive landscape facts"Notion AI does not expose knowledge via MCP"
team / ownershipPeople, roles, responsibilities"Head of Product owns the roadmap and pricing"
strategy / OKRGoals, initiatives, key results"Q2 goal: reach 500 active MCP connections"
process / workflowHow things are done internally"All new hires complete a 30-day onboarding sprint"
metric_definitionWhat your metrics mean"Activation = first MCP query within 7 days of signup"
risk / constraintKnown limitations, risks"We do not support on-premise deployment"
glossaryInternal terminology definitions"'Brain' refers to the full knowledge base of a workspace"

Strategy Facts

Facts in the strategy category have additional fields: strategy_type, strategy_owner, strategy_status, and review_date. These are synced from OKR platforms (Perdoo, Weekdone) and flagged for review when deadlines approach.

Confidence Score

Each Fact carries a confidence score from 0.40 to 0.95. Scores reflect how certain the extraction pipeline is about the fact. You can override any score during review. Scores above your workspace threshold (default 0.70) are eligible for direct approval.

Proposals

Proposals are the Review Queue — the holding area for candidates that need a human decision before becoming Facts. Every piece of automated intelligence lands here first.

Reviewing proposals

Open the Review Queue from the sidebar. Each card shows the proposed statement, category, confidence score, source, and supporting evidence.

Keyboard shortcuts

VVerify — approve the proposal as a Fact
DDismiss — reject the proposal
↑ / ↓Navigate between proposals
EEdit the statement before approving

Bulk review

Select multiple proposals with the checkboxes and use the bulk action bar at the bottom of the page to verify or dismiss all at once. Useful after a large upload or agent run.

Conflict badges

If a proposal contradicts an existing Fact in the same category, it shows a conflict badge. Click to see which Fact it conflicts with before deciding.

Evidence & Signals

Evidence

Every approved Fact is backed by traceable evidence — the source excerpts, quotes, or data points that the extraction pipeline found. Evidence is created automatically during upload. You can also add evidence manually to any Fact from its detail panel.

Signals

Signals are observations that don't directly become Facts but are worth tracking. Brain Agents create signals when they detect market shifts, competitive moves, or internal changes. Signals with high importance scores are surfaced on the dashboard. Over time, clusters of signals can trigger new proposals.

Signal TypeDescription
market_shiftIndustry trends, regulatory changes, technology shifts
competitive_moveCompetitor product launches, pricing changes, announcements
customer_feedbackUser sentiment, testimonials, churn signals
internal_eventHires, launches, milestones, pivots
risk_alertEmerging threats, blockers, dependencies

Data Upload

The Data Upload page is the fastest way to get knowledge into Company Brain. You can upload a file or paste text — Claude AI does the extraction automatically.

What to upload

Any text-based business document works well: company decks, strategy briefs, one-pagers, CRM exports, board updates, pricing sheets, or org charts. The extraction pipeline is optimised for dense, structured business language.

Two-pass extraction

Every upload runs two Claude passes:

Pass 1 — Structured facts

Extracts concrete, verifiable statements: names, roles, numbers, dates, product names, market definitions, pricing figures.

Pass 2 — Strategic context

Extracts softer, interpretive knowledge: mission, positioning language, workflow descriptions, strategic rationale, competitive framing.

Supported file types

PDF, DOCX, TXT, MD. Maximum file size: 20 MB. For spreadsheets, export relevant sheets as CSV or paste the data directly.

Quality tip

Well-structured documents with clear headings and labelled sections produce significantly better extraction results than raw text dumps. A 2-page structured brief often outperforms a 20-page unstructured document.

Brain Agents

Brain Agents are autonomous background workers that keep your knowledge current without manual intervention. Enable them once — they run on a shared hourly scheduler and propose updates as your company and market evolve.

Built-in agents

AgentWhat it doesAvailable on
DigestSummarises recent Facts, Proposals, and Signals from the past 7 days and delivers a weekly digest email to workspace members.All plans
Website IntelligenceMonitors your own website for changes in positioning, messaging, pricing, and product structure. Creates Proposals when drift is detected.Pro & Team
Competitor IntelligenceScans competitor websites for pricing changes, product launches, and positioning shifts. Creates Signals and flags risks.Team
Market SignalMonitors configured market categories for language drift, sentiment shifts, and emerging frames. Creates Signals.Pro & Team
OKR AlignmentScores Facts and Signals against your active OKRs. Detects coverage gaps and surfaces misalignment. Requires an OKR integration.Pro & Team
Source ChangeMonitors registered sources for staleness. Creates Signals when sources exceed their expected update frequency.Pro & Team

Integration agents

Each connected integration has its own sync agent that runs incremental updates on a fixed schedule — HubSpot, Salesforce, and Pipedrive every 6 hours; Slack and Teams every 2 hours; Notion every 4 hours; Perdoo and Weekdone every hour. Syncs create Proposals when new or changed data is detected.

Agent runs

You can trigger an agent run manually from the Brain Agents page by clicking Run now. Each run is logged with duration, proposals created, and any errors. Recent runs appear in the agent's history panel.

Integrations

Integrations connect Company Brain to your existing business tools, enabling automatic knowledge extraction without manual uploads.

CRM integrations

IntegrationWhat it extractsSetup
HubSpotCompany records, contact roles, deal data, pipeline stages, customer segmentsOAuth — connect in Settings → Integrations → HubSpot
SalesforceAccounts, opportunities, team hierarchy, product usage, pipeline metricsOAuth — connect in Settings → Integrations → Salesforce
PipedriveDeal pipeline, person records, company data, activity typesOAuth — connect in Settings → Integrations → Pipedrive

Knowledge & collaboration

IntegrationWhat it extracts
Google DriveDocs, Slides, DOCX, PPTX, PDFs — extracts company content, client deliverables, proposals, financial norms, presentations, templates
NotionDatabase properties, page content, structured knowledge — maps Notion databases to Brain categories
SlackChannel discussions, important announcements, team signals, communication patterns
Microsoft TeamsTeam structure, channel activity, key decisions and announcements

Strategy & OKR

IntegrationWhat it extracts
PerdooCompany goals, OKRs, KPIs, initiatives — synced as strategy Facts with owner and review date
WeekdoneWeekly check-ins, progress scores, blockers, wins — creates strategy signals and updates existing strategy Facts

Sync frequency

All integrations run incremental syncs every 6 hours by default. Full re-syncs happen when you first connect or when you change the integration config. You can trigger a manual sync from the integration's status page.

Security

All integration tokens are stored encrypted at rest. Company Brain uses read-only OAuth scopes wherever possible. Tokens are refreshed automatically before expiry and revoked immediately on disconnect.

MCP Connect

The Model Context Protocol (MCP) is an open standard that lets AI clients fetch context from external servers. Company Brain acts as an MCP server — your AI clients query it to load your company's verified knowledge into every session.

Supported clients

Copilot
GitHub Copilot
Claude.ai
Claude Desktop
Cursor
Devin Desktop
Cline
ChatGPT
Other

Setup

1

Generate an API key

Go to MCP Connect and click Add connection. Select your client type and generate a key. The key is shown once — save it.

2

Add the MCP server to your client

For URL-based clients (Claude.ai, Cline, ChatGPT): add the URL directly in settings. For JSON-based clients (Claude Desktop, Cursor, Devin Desktop): paste the JSON snippet into your config file.

3

Test the connection

Open your AI client and ask something like "What do you know about our company?". If context loads, the connection is working.

MCP server URL

https://mcp.company-brain.ai/mcp?key=YOUR_KEY

JSON config snippet (Claude Desktop, Cursor, Devin Desktop)

{
  "mcpServers": {
    "company-brain": {
      "type": "http",
      "url": "https://mcp.company-brain.ai/mcp?key=YOUR_KEY"
    }
  }
}

Available MCP tools

Once connected, your AI client can call any of these tools during a session:

ToolDescription
companybrain_get_company_profileRetrieve the current company profile and metadata
companybrain_register_sourceRegister a new knowledge source for ingestion tracking
companybrain_list_sourcesList all registered knowledge sources
companybrain_submit_evidenceSubmit a raw evidence item for review
companybrain_list_evidenceList evidence items with optional filters
companybrain_create_entityCreate a named entity (person, product, org, etc.)
companybrain_list_entitiesList entities with type and name filters
companybrain_record_signalRecord a business signal or event observation
companybrain_list_signalsList signals filtered by type or date range
companybrain_create_proposalPropose a new fact for human review. Write path only — does not return data for answering questions. The proposal enters a review queue and does not become a live fact until approved.
companybrain_list_proposalsList pending and resolved proposals
companybrain_review_proposalApprove or reject a pending proposal. An approved proposal becomes a verified fact. A rejected proposal is closed with no fact created.
companybrain_get_factRetrieve a single approved fact by ID
companybrain_list_factsPrimary tool for retrieving verified company facts. Always filter by category when the question concerns a specific domain. Valid categories: company_overview, mission, vision, market, icp, persona, product, feature, pricing, positioning, messaging, competitor, workflow, policy, constraint, process, team, ownership, metric_definition, strategy, risk, glossary.
companybrain_create_factCreate a fact directly, bypassing the proposal queue. Requires owner or admin privilege. Write path only — does not return data for answering questions. Use companybrain_create_proposal unless explicitly granted admin rights.
companybrain_get_knowledge_packOrientation overview of the company knowledge base. Returns a category index (each fact category with its count), business rules, glossary terms, and recent changes — but not the full fact rows. Call this at the start of a session to understand what knowledge exists and which categories are relevant. Then call companybrain_list_facts filtered by category to retrieve actual facts.
companybrain_list_recent_changesList recent changes to the knowledge base
companybrain_list_knowledge_conflictsList detected contradictions between proposals or facts
companybrain_get_okr_contextGet the current OKR context — active objectives and key results, progress, alignment to facts and signals, and coverage gaps. Use for goal-setting, planning, and direction decisions.
companybrain_resolve_business_glossary_termLook up the company's canonical definition of a specific term before using it in an answer. Call proactively on any company-specific terminology. Returns found=false cleanly on a miss; never an error.
companybrain_get_business_rulesRetrieve business rules before generating advice, commitments, or any output that could conflict with company policy. The enforcement tier (hard/soft/default) tells you how strictly each rule applies. Filter by category for focused retrieval.
companybrain_get_business_glossaryBrowse the full glossary vocabulary for a domain. Use when you need to understand what terminology exists across a category. For a single known term, use companybrain_resolve_business_glossary_term instead.
companybrain_propose_business_ruleFile a proposal to add a business rule for human review. Does not create a live rule — the proposal must be approved first.
companybrain_propose_business_glossary_termFile a proposal to add a glossary term for human review. Does not create a live term — the proposal must be approved first.

Team Key Sharing

Team key sharing lets your colleagues connect their AI tools to Company Brain without needing a Company Brain account. One company key, shared via a link — teammates connect in under two minutes.

How it works

1

Generate a company key

Go to Team and click Generate Company Key. This creates a single shared key tied to your workspace.

2

Share the setup link

Copy the setup link (format: company-brain.ai/team-connect?key=…) and send it to colleagues via Slack, email, or any channel.

3

Teammates connect

When a colleague opens the link, they see your company name, pick their AI tool, and click Connect. Their setup instructions are pre-filled with the key. No login required.

Connection tracking

The Team page shows how many teammates are connected and which AI clients they're using (Cursor, Claude Desktop, ChatGPT, etc.). This updates in real time as colleagues connect.

Revoking a key

Revoking the company key immediately disconnects all teammates using it. They will need to reconnect using a newly generated key. Revoke only if you believe the key has been compromised, or to rotate access when team members leave.

Roles & Permissions

Company Brain uses four role levels. Roles are set per workspace member and control what each person can read, write, and approve.

RoleCan do
OwnerEverything — including billing, deleting the workspace, and assigning roles to others.
AdminAll data operations: create/edit/delete Facts and proposals, manage integrations, invite members, generate company keys, run agents.
ValidatorReview and approve/reject proposals. Create evidence and signals. Cannot manage integrations or billing.
ContributorSubmit proposals and evidence. Read all Facts, signals, and entities. Cannot approve proposals or manage the workspace.

Inviting teammates

Go to Invite Others from the sidebar. Enter the email address and select a role. The invited person receives an email with a unique link. Links expire after 7 days.

Company key vs. workspace membership

Teammates who connect via the company key (Team page) are not workspace members — they only get read access to your knowledge via MCP. They cannot log in, review proposals, or manage anything. For full workspace access, invite them via Invite Others.

Plans & Pricing

Company Brain is available on three plans. All plans include the core knowledge engine — facts, proposals, evidence, signals, glossary, business rules, and MCP access. Higher plans unlock more members, capacity, and advanced agents.

Free

$0 /mo

  • 1 workspace member
  • Unlimited sources
  • 50 facts
  • Unlimited proposals
  • Digest Agent
  • MCP Connect

Pro

Popular

Pro see billing

  • 5 workspace members
  • Unlimited sources
  • 2,000 facts
  • 2,000 proposals / month
  • Website, Market & OKR agents
  • Team key sharing

Team

Team see billing

  • 25 workspace members
  • Unlimited sources
  • 5,000 facts
  • 10,000 proposals / month
  • All agents incl. Competitor Intelligence
  • Priority support

Upgrade your plan

To upgrade, go to Billing from the user menu at the bottom of the sidebar. You can view your current plan, usage, and upgrade at any time.

FeatureFreeProTeam
Workspace members1525
Knowledge sourcesUnlimitedUnlimitedUnlimited
Facts502,0005,000
Proposals / monthUnlimited2,00010,000
Digest Agent
Website Intelligence
Market Signal Agent
OKR Alignment Agent
Competitor Intelligence
Team key sharing
Priority support

Business Glossary

The Business Glossary is your company's canonical dictionary — a curated set of terms, definitions, synonyms, and scope boundaries that give AI tools a shared vocabulary for understanding your business.

Without a shared glossary, AI tools make assumptions. "ICP" might be interpreted as a generic marketing concept rather than your specific customer definition. "Activation" might follow a textbook formula rather than the metric your team actually measures. The glossary closes that gap by injecting your definitions into every AI session via the MCP knowledge pack.

What a glossary term contains

FieldPurpose
TermThe canonical name for the concept — what your team actually calls it
DefinitionA precise, agreed-upon explanation of what the term means in your context
SynonymsAlternative names or abbreviations used for the same thing, so AI recognises them too
CategoryGroups the term by domain: product, market, strategy, process, metric, etc.
Boundary noteClarifies what the term does not cover — reduces misapplication
Confidence scoreHow certain Company Brain is about the definition (0.40–0.95)

How terms are added

Terms can be added manually via the Glossary page, proposed by Brain Agents during fact extraction, or surfaced when the extraction pipeline encounters a term it cannot resolve. Terms marked Needs definition have been recognised as important but not yet defined — they appear as a work queue on the Glossary page.

Editing terms

Changes to glossary terms go through the proposal workflow — edits create a new versioned record pending review, so the canonical definition is never overwritten without an approval step. The previous version is retained and traceable.

Glossary and AI context

When an AI tool calls the companybrain_get_business_glossary MCP tool, it receives your full active glossary. The companybrain_resolve_business_glossary_term tool lets AI resolve a specific term by name or synonym, including fuzzy matching.

Business Rules

Business Rules are explicit, machine-readable statements that capture how your company operates — what is required, what is forbidden, what is permitted, and what depends on conditions. They give AI tools guardrails so they can reason within your actual operating constraints, not generic assumptions.

Rule anatomy

FieldPurpose
StatementThe rule itself, written as a clear declarative sentence
DirectionRequires · Forbids · Permits · Conditional — how the rule applies
Enforcement tierHard (absolute) · Soft (strong default) · Default (normal practice)
ConditionOptional: when the rule applies — "when dealing with enterprise customers", "in regulated markets"
RationaleWhy the rule exists — helps AI understand intent, not just the constraint
CategoryGroups the rule by domain: pricing, process, legal, product, hiring, etc.

Enforcement tiers

Hard

Absolute. No exceptions. Used for legal obligations, regulatory constraints, or non-negotiable company policy.

Soft

Strong preference. AI should follow by default but can deviate when context clearly justifies it.

Default

Normal practice. Describes how things are typically done. Lowest friction to override.

How rules create value

A well-maintained rule set means your AI tools know not to quote custom pricing without approval, not to promise delivery timelines that violate SLA policy, and to always recommend legal review for contracts above a certain threshold — without anyone having to prompt them. Rules shift AI behaviour from generic to company-specific at inference time.

Adding and editing rules

Rules are added via the Business Rules page. Like glossary terms, edits go through the proposal workflow — every change creates a new versioned record pending review, preserving the audit trail.

Rules and AI context

The companybrain_get_business_rules MCP tool returns your full active rule set to any connected AI client. Rules are included in the knowledge pack alongside facts and glossary terms, so they inform AI reasoning automatically — no manual prompting required.

Still have questions?