com.getfreedomos/freedom-mcp

List ALL connected external integrations — MCP servers, OAuth accounts (Google, X, ...), and direct integrations (Xero accounting, Stripe) — and the tools each one powers. Also reports accounts the operator already admins on another FreedomOS company (reuse) and FreedomOS-native doors. Use when ask…

Execute a tool on a connected MCP integration. First use list_integrations to discover available tools. [outbound-tier — list/read and content drafts can graduate after one Yes (per connection). Publish/send and spend connectors stay on the per-send human rail: each send is its own approval.]

When a goal needs a service, search here — do not stop at not-connected. Returns this company's existing connectors, accounts the operator already admins on another FreedomOS company (reuse: "use that account?"), FreedomOS-native doors (house Stripe receive, Cloudflare hosting), then the vetted/ren…

Climb the door ladder for a needed service: bind this company's connector, offer reuse of an account the operator already admins on another FreedomOS company ("use that account?"), use a FreedomOS-native door when we can, then a vetted/rented connect card. Use when a goal needs a service that is no…

Start, poll, or finish FreedomOS-native vendor sign-in (X, Slack, Meta, Xero) after the operator approved the Connect card. action=start mints once and returns authorize_url only when open=true — open that URL once. If already pending, start reuses the mint and does not return a URL (do not open an…

Bind a remote Streamable HTTP MCP onto this company from an https URL. Optional static headers (Authorization and API-key names refused — keys stay in Vault). Tools then show up on list_integrations and run through invoke_integration. Company managers only. Use when an operator or GM wants this com…

Grant ONE specific tool to an agent's loadout (tool_access). Use when an operator says "give <agent> the <tool> tool" / "let <agent> use <tool>". The tool name is validated against the live registry at write time — phantom names are rejected, deprecated names auto-map to their successor. For wholes…

Remove ONE specific tool from an agent's loadout (tool_access). Use when an operator says "take <tool> away from <agent>" — or to clean a phantom/stale name out of a loadout (unresolvable names ARE removable here, unlike grant). Reports honestly when the name was not present, and when the tool is a…

File a bug report or feature request about FreedomOS the platform (FO UI, MCP tools, Command Center, auth, connectors, FO agents runtime) with the FreedomOS product team. Creates a FO product-inbox Command Center card and returns a request_id you can poll with get_product_request_status. ONLY for F…

Check status of a product request you previously filed with submit_product_request for your operator. Returns pending | approved | denied | dismissed | completed so you can tell your human when FreedomOS product team decides. Use when you hold a request_id and need an update for the filer.

MANUAL ONLY — open a draft GitHub PR shell for an approved FreedomOS product request. Approve no longer auto-opens a ticket PR (that class emailed the operator and polluted ship-seat). Prefer the builder spawn rail. Use this only when product team explicitly wants a tracking PR. Do NOT use for ques…

Attach an existing freedom-ai GitHub PR URL to a product request and **resolve it by construction** (card → approved, product_status=fixed, history comment, filer resolution notify). Use when you (or a coding agent) opened a real PR for the fix — no separate human close step. [write-tier — first u…

Mint a paste-ready Builder claim recipe for a FreedomOS product request so a host coding agent (Grok Build / Claude Code) with Harness + gstack can implement the class fix. Pins the FreedomOS frontier coding model (TIER_ROLES.frontier). Does NOT run the coding agent or open a PR by itself — use aft…

Scan a company for product-system bugs and unlocks (failed/timed-out activity runs, blocked_on_you cards, open error agent_feedback) and return ranked product-request candidates for the FreedomOS product team. Use when the product team is hunting class bugs/unlocks across a portfolio tenant (dry-ru…

Get a real-time snapshot of team output volume, pending approvals, and founder load. pending_cards is the LIVE open queue (includes cards older than `days`). activity_runs and approval_velocity are the last N days only. Shows cards per agent, approval velocity, oldest pending items, and load trends…

Audit all agent activities for staleness, business outcome alignment, and cross-agent overlap. Returns per-activity description, linked_kr_id, run count, all-time quality/approval (as_of = last run), and flags. summary.unaligned / unaligned is activities with no per-activity Key Result (same grain…

Trigger a specific agent to run a specific activity immediately. This dispatches the work and returns — it does not wait for the activity to complete. Use this to direct agents to take action. [sensitive-tier, initiates a multi-step agent process — first use may require a manager's approval; a fro…

Run a saved Playbook (growth_tactics) for the company operator or agent — dispatch the next unit as a one-off draft activity, or dry-run a Playbook brief with suggest_only. Use when the operator or agent should execute an Agreed playbook this cycle (same owner as Focus “Run play”), or preview cast/…

Pause or resume an agent's scheduled activities — the whole activity plan, or a single activity via activity_name. Pausing stops future scheduler-dispatched runs until resumed; manual trigger_agent_activity still works and in-flight runs are not affected. Routing: Pause a misbehaving/low-quality a…

Get detailed performance stats for a specific agent: run count, quality scores, approval/denial rates, error count, recent errors with context, and slowest runs. Use this to audit agent health, trace problems, and identify improvement opportunities.

Add ONE activity to an agent's activity plan without regenerating the whole plan. Use to give an agent a new recurring or one-off deliverable. (To rebuild the entire plan, use recalibrate_agent_jd with regenerate_activities=true instead.) [sensitive-tier — first use may require a manager's approva…

Edit ONE existing activity in an agent's plan — change its name, description, frequency, tools_used, deliverable, or completion_criteria. Surgical alternative to regenerating the whole plan. [sensitive-tier — first use may require a manager's approval; a from-now-on approval makes future calls sea…

Split ONE oversized activity into smaller activities (intake + finish) without regenerating the rest of the plan. Use when a run hit the continuation safety backstop while still progressing — the activity is bigger than one deliverable. Routing: Splitting an oversized activity → use this (archives…

Draft a Play (growth_tactics with steps + human review) from an oversized agent activity. Does not run the play — operator Agrees via agree_playbook (MCP/Chat) or Focus first. Use when a run hit step/continuation limits because the work is multi-unit. [sensitive-tier — first use may require a mana…

THE tool for the founder's attention budget — the operator-set ceiling on pending review cards before they are 'overloaded' (e.g. "what's my attention budget?", "how many pending cards is too many?", "is my overload threshold the default?"). Returns max_pending_cards and is_default (whether it's st…

Set the founder's attention budget — the maximum pending review cards before they are 'overloaded' (a whole number 1–100; default 7) — for a manager or the founder. Use when the founder (or a manager on their behalf) wants to raise or lower their overload threshold (e.g. "set my overload threshold…

Queue a short instruction for an external agent session — a coding/builder host (Grok terminal, Claude Code) or a Grok Bot desktop chat agent (host grok-bot, e.g. "send this to my FOS Integrator"). Pull sticky only: FreedomOS does not wake the host and does not type into their UI — the session must…

List pending attention directives for THIS operator (optionally filtered by target_session_id). Hosts (Grok/Claude) and CoS use this to see what is waiting. Does not ack — use ack_attention_directive after acting.

Mark a pending attention directive as acked after the host session has taken the instruction. Use when YOU are Grok/Claude/a host builder and you just executed (or deliberately skipped) a directive you polled — for the same operator who owns the queue. Idempotent on already-acked → not found. [wri…

Cancel a pending attention directive (operator changed mind / wrong target). Use when the operator says drop/cancel that instruction to Grok or Claude, or CoS realizes the target_session_id was wrong — for THIS operator only. Does not reverse work the host already did. [write-tier — first use may…

Route the operator's desk HUD to a view they asked to see — open a door (money, sessions, home, roster, loadout, upgrades), lock a company zone, drill into a company's money, fill the pixel well with the focused card's breakdown, focus a SPECIFIC pending card, or go back. UI navigation only: change…

List THIS operator's coding/builder sessions (status, goal, ask). Hygiene: drops stale hosts (no recent heartbeat) and blocked rows without a real ask. Use needs_me=true for "what needs me?" (blocked only). Use before create_attention_directive or when attending a blocked session.

List THIS operator's Grok Bot desktop chat seats (not Terminal/ACP coding Groks) with live/quiet/gone labels and last turns. Use when they ask to see or talk about their Grok Bots. Omit seat to list; pass a slug for one seat. Send uses create_attention_directive even if the seat is quiet — the stic…

Speech-safe Quest Log strip for voice CoS (N5). One call returns: primary next move (featured Command Center card when companyId given, else top host that needs you), needs_you hosts, running host count, work_units (sessions · lab_work cascade · ship-seat open PRs — same inventory as Quest Work rai…

Read the Mac desk factory snapshot for THIS operator (ACP up/down, last launcher event, official workers vs leftover UUID/TUI tabs, Terminal fallbacks in 24h). Use when a Foreman or voice CoS asks if the factory floor is up, whether a spawn went ACP or Terminal, or how many leftover grok-01a0 tabs…

Park THIS operator's coding host sessions (N6 hygiene). Use after "clean tabs" / "park ghosts" / list shows dead running hosts. Pass session_ids for explicit targets, or stale_running=true to park running/unknown hosts that failed freshness (no recent heartbeat). dry_run=true previews only. Marks F…

Raise an EXISTING coding tab on the operator machine (OS focus) for THIS operator's desk. Use when they say "show me that Grok", "bring up Claude", or "focus the freedom-ai session". Queues ATTENTION_FOCUS_V1 sticky for desk launcher (same bus as spawn). Does not inject work — pair with create_atte…

Close an EXISTING coding tab on the operator machine for THIS operator. Use when they say "close that session", "kill that Grok tab", or "shut the stuck Claude". Queues ATTENTION_CLOSE_V1 for desk launcher + parks the FO session row. Default is safe close (idle tab / SKIP-LIVE if CLI still running)…

Transfer work for THIS operator: push an instruction to a target coding session (or spawn one), optionally close/park the source. Use when they say "move this to a fresh Grok", "hand that off to Claude", or "continue on freedom-ai in a new tab". Composes create_attention_directive or request_attent…

Emit or update thin session telemetry for THIS operator (host coding agent self-announce). Use when YOU are Grok or Claude Code at session start / status change so voice CoS can list_attention_sessions and target you. Prefer tiny goals; never dump transcripts. [write-tier — first use may require a…

Append one durable speech/taste preference for THIS operator only (re-injected on their next voice session mint). Use when they say something was hard to follow, how cards should sound, or "remember I prefer…". For this user_id only — does not edit the shared FreedomOS CoS template. Apply the note…

Append one settleable CoS lesson for THIS operator only (self-improve construction). Use after a clear win/miss on a call: what worked, what failed, which principle. Short notes only — not transcripts. Re-injected at next voice mint (open + settled_keep). Faith content stays operator-authored — nev…

List THIS operator's CoS lessons (open + settled_keep by default) for self-improve memory. Use when reviewing what CoS has learned for this user only before a long call or hygiene pass. Not cross-user.

Replace THIS operator's full CoS preference block (or clear with empty). Use when they want a full rewrite of saved preferences. Per user_id only — not a global product prompt edit. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just…

Read THIS operator's saved CoS speech/taste preferences (user-scoped). Use when confirming what you will remember about how they like cards and talk.

List THIS operator's recent CoS telemetry (operator_cos_events: open/speech/close, host_push actions, card_decide/confused/buggy). Use to verify dogfood soak, or before propose_cos_content_atoms. Never invent events. Do not speak UUIDs aloud — counts + kinds only unless they ask for detail.

Marketing-by-construction: pack THIS operator's recent CoS telemetry into one-job content atoms (Proof/Story/Take · Wisdom/Proof factories). Use after a dogfood call or when they ask "what posts can we make from this CoS work?" Never invents facts not in events; never auto-posts (human publish rail…

Read your role brief. Call this FIRST on every turn: it returns the company you work for, what this role is for, the numbers it moves, what is due right now, recommended_host_wake (how often your host should poll — FreedomOS does not wake you), anything waiting on your operator, and any notes left…

Stamp one due job as done after you deposit the work. Use when get_my_role listed this activity in due_now and you have already deposited the deliverable — depositing knowledge is not enough; this write is what clears due_now. Pass the exact activity name from the brief. A role key stamps its own r…

Create a Playbook for the company (growth_tactics — the Plays rail). Use when the operator wants a reusable runnable loop or playbook — not a Knowledge file. SOP and reference docs stay on save_knowledge. Routing: Playbook / reusable company loop → use this. SOP / guidelines / notes → save_knowled…

List Playbooks for the company (growth_tactics — the Plays rail). How-to rides as description (alias of custom_instructions) — same name create_playbook / update_playbook write. Use when asking what playbooks exist, or before run_playbook / update_playbook. Filter by category or status. Routing: W…

Read ONE Playbook by id or title — operator contract (outcome, who, what Yes authorizes), steps, plan Agree seal, assignee, how-to (description = custom_instructions). Use before agree_playbook / run_playbook. list_playbooks is the index (same description key). Routing: Inspect one Playbook (steps…

Rewrite one engine-drafted Play into an English operator contract (outcome, who, what Yes authorizes). Clears Agree. Does not run. Use on first Focus view leftovers or when get_playbook still shows an activity slug as the title. Routing: Engine slug Play → English contract → use this, then get_pla…

Portfolio sweep: re-draft every assigned engine-photocopy Play in this company into an English operator contract. Clears Agree on each. Does not run. Operator sits through the list. Routing: Clean engine Play slugs across this company → use this [write-tier — first use may require a manager's app…

Send this Playbook. If to_email is an existing FreedomOS user, copy the Play onto their company (they still Agree). If they are new, return your invite link (partner /start/{slug} or /r/:code). Operator door. Exec cannot mint a share. Routing: Send a Playbook to a teammate or a new person → use th…

Seal a Playbook plan (source_details.plan_agreed_at) so run_playbook can dispatch. Operator door — Chat or MCP. Same seal Focus writes. Structured Plays refuse Run until this exists. Use after get_playbook when the steps look right. Routing: Agree who does what on a Playbook → use this, then run_p…

Update an existing Playbook (growth_tactics). Use when changing title, how-to / instructions, status, category, assignee, or OKR binding (objective_id / linked_kr_id). Identify by title or ID. Routing: Edit a saved Playbook → use this [write-tier — first use may require a manager's approval; a fr…

Archive a Playbook (safe delete — recoverable). Use when the operator wants to retire a playbook. Identify by title or ID. Routing: Retire a Playbook → use this [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-as…

Get detailed company profile including mission, vision, settings, and lifecycle (active | archived, from companies.archived_at). Archived companies stay readable; do not treat them as live districts. To archive or unarchive, call set_company_lifecycle.

Update company profile. Can set mission, vision, elevator pitch, logo, website, or other details — and runtime_mode, which decides whether this company's roles run on the operator's own bots ("host") or on FreedomOS's own schedule ("fo"). Does not archive or unarchive — use set_company_lifecycle fo…

Archive or unarchive (restore) a company the operator can manage. Use when get_my_companies shows lifecycle=archived and the operator wants it active again, or when they want to archive a live district. This is the MCP/chat door for company lifecycle — the same archive_company / unarchive_company R…

Author or update the company's grand slam OFFER — the operator-authored positioning agents ground all outbound in (the offer half of the product layer). Sets `offer` (what the company sells + the transformation it promises) and an optional `target_summary` (who it's for). Capability truth — what th…

Create a new company in this operator's portfolio. Pass name (required) and optional about and website. Returns the new companyId. Extra company on Solo is $47/mo, charged on the existing FreedomOS subscription before the company is created — fails closed if not paid. Portfolio already covers every…

Return a Stripe checkout link so this signed-in person can pay for FreedomOS Solo ($47/mo) from chat. Use when they have no business yet and are not subscribed. Optional: holdco_name, founder_why, website — the same short setup interview (name, website, what should come off their plate first). Does…

The free look before paying: give the business website (http/https) — or the four short answers (what the business does, who for, what eats the week, what they would hand off first) — and FreedomOS reads it back: the first jobs it would take off their plate and what it read on the site. For a signe…

Scan the company's connected source code (its GitHub repo, via the Pulse connection in Smart Tools) and DRAFT a capability list — shipped FEATURES (each citing the file that proves it) plus attempted can't-do LIMITS — for the operator to ratify. It writes NOTHING: only items the operator ratifies b…

Persist the operator-CONFIRMED derived features (from derive_capability) into the product capability index as source='derived'. Call ONLY with features the operator has ratified — each then becomes an authoritative capability the marketing agents and the Integrity Gate use. Idempotent (re-ratifying…

List objectives and key results for the company. Each KR current is THIS calendar month (see month_updated + monthly_history) — not YTD, not a future projection, not the due-date month. Refresh cash numbers from get_financial_summary (displayed_net_cash_flow) and Amazon deposits from get_monthly_tr…

Create a new objective (the O in OKR). Objectives are aspirational goals. After creating one, use generate_key_results to get intelligent, context-aware key result suggestions, then create_key_result to add the best ones. An objective without key results has no way to measure progress. [write-tier…

Update an existing objective's title, description, or year. Identify by objective_id or objective_title (preferred). If the title matches more than one active objective it refuses and lists them — pass objective_id to disambiguate. Use when the operator wants to rename or reword an objective or mov…

Add a key result to an objective (the KR in OKR). Key results are measurable outcomes that track progress toward the objective. You can identify the parent objective by title or ID. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just…

Update a key result for the company operator and any agent owning KR progress (progress, assignment, due date, rename, measure binding). Use when work moves a Key Result and you need to log current value, reassign, rename, or bind a measure source. Prefer key_result_id — the parent objective is res…

Generate intelligent, context-aware key result suggestions for an objective. Uses company mission, vision, financials, and existing KRs to produce high-quality suggestions tied to north star metrics. Returns suggestions that you can then create with create_key_result. [write-tier — first use may r…

Get the company's core-tenet setup completeness — mission, vision, OKRs, finances, ICP, branding, team, integrations, product, revenue channels, ICP agent model — each as done/empty/blocked/n_a/unknown, with a score, the next best setup step, and the tool to fix each gap. Derived live from current…

Start a new company in conversation — one next step at a time. Dream first (capture_idea), open the company when that mint is live, then drive from get_setup_state: they write mission and vision (draft_tenet_from_signal only if a website is on file), set_offer, create_icp, pin_constraint, request_c…

Read a web page and return its content as clean markdown. Use when the user asks to read, analyze, summarize, or extract information from a specific URL. Also useful for competitor research, checking a website, or reading an article. Routing: Best for articles, landing pages, blog posts, documenta…

Draft a company tenet (mission or vision) FROM the company's existing website, for the operator to ratify or edit — instead of asking them to type it into a blank field. Use when a tenet is empty but the company already exists (has a website). Returns a DRAFT proposal with evidence and a confidence…

List what content material this company already has (knowledge folders like book-1/canon, SME Expert rules, idea_inbox assigned to this company). Use BEFORE inventing posts or when the operator asks 'what content do we have?'. Read-only; no LLM. Prefer promote_corpus_to_content next to mint cards.

Mint the NEXT content angle(s) from the company's corpus into content_ideas + Command Center cards. Default count is 1 — do NOT bulk-fill the queue. For day-to-day drafting, prefer list_knowledge / read_knowledge (or list_corpus_inventory) to pull one chapter/passage JIT — that avoids re-tokenizing…

Render a multi-slide image carousel + a LinkedIn-PDF from structured slide copy. Text (including the cited answer) is rendered as REAL, legible text — never the garbled in-frame text AI image/video models produce. Use for value-demonstration B2B content (the cited-answer overlay, peer-proof decks).…

THE tool for "did this piece ship on this channel" — reads the cross-channel Release Ledger, the queryable truth for every confirmed send (x/linkedin/instagram/facebook/threads, hub letters, Beehiiv) written by the publish rail itself at send time. Use this instead of title-matching or a markdown t…

List shared work-graph items (lab_work_items) for the operator or coding agent in the current company — the cross-session shared plan. Use when coordinating queued/blocked/in-progress work across sessions, or reconciling a PR stamp (returns row title plus thin identity: pr, artifact, card_id, spawn…

Create a new shared work-graph item (lab_work_items) so it is visible and coordinated across sessions and agents. Set depends_on to gate this item behind others (it starts blocked until they complete). Optionally pre-assign to an agent OR a user. [write-tier — first use may require a manager's app…

Mark a shared work-graph item resolved — verified (default), published, or cancelled. In the full system, resolving an item cascades to unblock items that depend on it, so this is a process-initiator. Optionally record a verified_outcome. [sensitive-tier, initiates a multi-step agent process — fir…

KR2 census for the current company: over the STAMPED builder landings of the trailing 28 days, the share that named a Key Result at birth or is factory-self-classed (landings_aligned_pct_28d) — factory-self credited at most a fifth of stamped landings, the excess reported as landings_factory_self_o…

Get the current user's profile information including name, title, contact info, and personal details.

Update the current user's profile. Can set name, title, phone, linkedin, location, zone of genius, or quiet hours (the do-not-disturb window for agent push alerts). [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re…

List the companies the current operator can act in (their FreedomOS portfolio). Every membership stays listed — testers and archived are not hidden. Each row has role, `lifecycle` (active | archived, from companies.archived_at), and `about` (entity type + what the company is/does). Walk lifecycle=a…

Get YOUR channel partner stats: student share URL (/start/slug), rev-share terms, referral counts by status (pending/joined/activated/credited), and REWARD state (rewardsVested = credits actually granted, rewardsClearing = paid but inside the 7-day vesting window, rewardsVoided = money returned bef…

Get YOUR classroom starter pack for students: the public share URL (https://getfreedomos.com/start/{slug}) where they copy a one-paste Claude prompt — no skill file, no AirDrop, no terminal. Also returns slug, unlockUrl (/p/{slug}) for mid-funnel pay-only if someone already coached, a short blurb y…

Onboard YOUR host coding CoS (Claude Code, Cursor, etc.) to FreedomOS: returns a LIVE MCP tool catalog + a deep-research prompt so the host agent reasons how to maximize profit-per-attention with FO — no fixed labor split. FO is hungry for contacts/ops state; host may build cheaper one-shots; FO wi…

Get P&L summary with revenue, expenses, and net income for the company. For single-month queries (e.g., "Feb free cash flow"), specify month parameter.

Get projected future values from financial forecasts. Shows what revenue/expenses are expected. Empty books return a structured empty object (has_data: false), not an error.

Compare actual financial results to budget/projections. Shows variance analysis.

List company transactions with optional filters. Use for expense tracking, transaction review.

Search transactions by description. Use when user asks about specific vendors, expenses, or payments.

Get month-over-month financial trends. Shows which accounts are increasing/decreasing.

Get current cash and bank account balances. Use for cash flow questions.

Get the user's freedom target (monthly income goal to quit day job), current FCF progress, estimated freedom date, and assumptions. Use when user asks about financial independence, freedom, or quitting their job.

Update projected values for specific accounts and months in the financial plan. Use this when the user asks to change a projection, forecast, or budget number. Empty books are created on first write (the named account is added as CASH OUT unless the name is clearly revenue). Only current and future…

Add or update a note on a P&L account row. Use this to annotate accounts with context like "Includes annual contract renewal" or "One-time consulting fee in June". [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-…

Add or update a note on a specific transaction. Use after pulling transactions to annotate individual items. Routing: Call get_transactions or search_transactions first to get the transaction_id — this tool cannot look one up by description [write-tier — first use may require a manager's approval…

Change the cash category on one company transaction. Use after get_transactions or search_transactions. Does not post to Xero — pair with set_xero_account_map and post_xero_transaction to book the locked code. Routing: Call get_transactions or search_transactions first to get the transaction_id. P…

Get Stripe metrics including average/median LTV, MRR, churn rate, active subscriptions, and an AI-recommended CAC target derived from the company's chosen LTV:CAC strategy (see get_cac_strategy / set_cac_strategy). Returns both blended company-wide metrics and per-plan-tier segments (e.g., Solo vs…

Get top customers ranked by lifetime value (LTV) or revenue from Stripe. Returns name, email, LTV, subscription status, and purchase count for each customer. Use this to identify high-value accounts and retention opportunities. Only works if Stripe is connected.

Get subscription statistics from Stripe — active, trialing, past-due, and canceled counts plus MRR and ARR. Use alongside get_stripe_metrics for a full revenue picture. Only works if Stripe is connected.

See whether this company can receive money (Stripe charges_enabled). Use when a sponsor or customer wants to pay and you need to know if checkout is live. If not receiving, call start_company_receive. If charges_enabled, call create_payment_link. Routing: Company can receive money / Stripe KYC / c…

Start the path for this company to receive money. Creates a Stripe connected account and returns an onboarding_url the founder opens on Stripe's hosted identity form (Stripe holds SSN/ID — FreedomOS does not). Use when the company cannot receive yet and a real payment is waiting (sponsor, invoice,…

Create a Stripe Payment Link so this company can collect a real payment (sponsor, invoice, one-off). Use when get_receive_status says charges_enabled (or start_company_receive already finished). Returns a checkout URL to send to the payer. Does not charge FreedomOS. Does not move money until the pa…

See this company's founder-granted spend envelope (Stripe Issuing card on the Treasury account). Use when you need to know whether the CEO can spend, at what monthly cap, or why spend is unreachable. If the platform is not Connect+Treasury+Issuing, this returns that catch honestly — do not mint a f…

Grant or raise this company's spend envelope: issue a Stripe Issuing card on the company's Treasury FinancialAccount with a monthly spending_limit the network enforces. Use when the founder is granting a cap (test case: $100/month = 10000 cents) or raising it, or setting merchant-class allow/block…

THE tool for any question about this company's CAC strategy or LTV:CAC ratio — e.g. "is our CAC strategy standard or conservative?", "what's our LTV:CAC ratio?", "what's our max CAC per customer?". Returns the operator's chosen posture — aggressive (2:1), standard (3:1), conservative (4:1), or ente…

Change this company's LTV:CAC strategy (the acquisition-spend posture): aggressive (2:1, early-stage growth), standard (3:1, recommended default), conservative (4:1, high churn / mature), or enterprise (5:1, long sales cycles). This governs marketing spend, so it is gated: an autonomous agent CANNO…

Declare where this business makes money — stripe, xero, shopify, amazon, ebay, manual invoicing, "none_yet" (pre-revenue), or other (name it). This is OPERATOR TRUTH an agent cannot derive, so it is gated: an autonomous agent CANNOT declare it — only a human (chat) or a graduated MCP operator can.…

Pin, re-pin, or release this company's binding revenue constraint as a DATED, FALSIFIABLE claim. Operator-only: live chat or a card a person approved — never an unattended run. A claim names the constraint, what you believe (8–280 chars), by_date (7–180 days out), and the registered demand number +…

Generate or EDIT an image using xAI Imagine (Quality Mode default = grok-imagine-image-2.0). Photorealistic, illustrations, flat graphics, icons, banners. 1K/2K. Single or multi-image edit (≤5 refs via artifact_ids / reference_image_urls). model_tier=standard for cheap drafts; model_tier=auto for 2…

Get all team members for the current company. Returns name, email, and role for each member. Use when user asks about team, company members, who is on the team, etc.

Add one human teammate to the current company by email. Creates a Command Center approval card (sensitive, every call). On approve: invite email + roster row. Required: email, role (job title, or team / manager). Optional: name. No bulk. No permission designer — team is the default access; pass rol…

Get complete AI team roster with roles, specialties, and capacity info. ALWAYS call this BEFORE recommending hires to check for existing coverage.

Per-agent "what did the compute buy" facts for the operator: trailing-14-day credits, runs (with self-maintenance share), human-accepted vs denied outputs, pending cards, last-accepted date, and a playing-house flag (activity with zero accepted output). Use when the operator asks whether an agent i…

Deactivate (archive) an AI agent/specialist from the team. Use when user says "remove [agent]", "deactivate [agent]", "archive [agent]", "fire [agent]", "delete [agent]". The agent is soft-deleted (is_active=false) and can be reactivated later. Cannot deactivate Linnet (the orchestrator). Routing:…

Restore an archived specialist in place (is_active=true on the existing row). Same id, JD, activities, and run history — never mints a twin. Use when the operator says "reactivate [agent]", "restore [agent]", "unarchive [agent]", or "bring [agent] back". Resolve agent_id from get_team_roster.archiv…

Research the company and return everything needed to propose a new role in ONE shot. Use when the operator wants to open a role, asks who to add next / what seats are missing / look at my team, needs a specialist, or describes a problem a standing seat would own. Call get_team_roster first to check…

Open a role with the brief from the interview. Use AFTER walking through the interview. The richer the brief, the better the seat. If get_team_roster.archived already covers the role, call reactivate_agent instead — do not mint a twin. [sensitive-tier, initiates a multi-step agent process — compan…

Create or update a skill (process/procedure) for an agent. Use when a user says "@Marcus here's how I want you to do the cash forecast" or "change how the CFO does the monthly review" or "here's my process for X". Skills teach agents HOW to perform their activities. [sensitive-tier — first use may…

Create a cross-agent collaboration request. Use when one agent identifies work that another agent should handle, or when the analysis reveals a gap that could be filled by an existing team member. Holdco chairs (Commander) are not teammates — class evidence is flagged for the holdco sweep, not hire…

Link an agent to one or more company OKRs. This creates a live connection between the agent and the company objectives they are working toward. Their system prompt will include live OKR context (objectives + key results with progress). [write-tier — first use may require a manager's approval; a fr…

Regenerate an agent's JD using fresh company context. Updates mission, expertise, guardrails, success metrics, and optionally activity plans. Works for both hired agents and Linnet. Use when the company has evolved, an agent needs recalibration, or the user wants to refine an agent's direction. Ro…

Rename a team member or fix its role/title. Updates an agent's display name and/or role/job-title. Use when the user says "rename X to Y", "call this agent Z", or "fix the title". For changing an agent's mission/skills use recalibrate_agent_jd instead. [write-tier — first use may require a manager…

Generate or regenerate AI agent profile avatar(s) for a company's AI team. Use when an operator wants to create, refresh, or restyle one or more agents' profile avatars. Single agent: pass agent_id OR agent_name. Several agents: pass agent_ids[] OR agent_names[] in ONE call. Whole team: pass all:tr…

Attach your own bot (Grok Bot, a Claude routine, ChatGPT) to one role in this company, and get the key to paste into it. The bot then reads that role's brief every turn with get_my_role — what the company is, what the role is for, the numbers it moves, what is due right now — and its work is credit…

Take back the key a bot was using to wear a role in this company. The bot stops being able to read the brief or act as the role from its next turn; the role, its brief and its history stay exactly as they are. Use when the operator says "detach", "revoke the key", "stop my bot running <role>", or w…

List all product features in the Feature Index. Use when user asks "what features do I have?", "show my features", "what have I built?", or wants to see their product capabilities for marketing.

Add a new feature to the Feature Index. Use when user says "I built X", "add feature Y", "track this capability", or describes a product feature they want to market. Features can later be pushed to Content Pipeline for marketing content. Routing: Title/description flow verbatim into marketing — ca…

Mark a feature as ready for marketing. Use when user says "mark X as ready", "this feature is ready to market", or wants to highlight a feature for marketing content. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval…

Update fields on an existing Feature Index entry — title, description, category, solves, limits, or demo_url. Use when the user wants to correct or enrich a feature's marketing copy. To change status use update_feature_status; to remove a feature from view use retire_feature — never delete. Routin…

Archive (retire) a feature so it stops showing to readers and agents, or restore a previously retired one. Safe-archive ONLY — never hard-deletes; retiring is fully reversible. Use when a feature is no longer accurate, was replaced, or the user says "remove this feature", "retire X", or "un-retire…

Get saved Ideal Customer Profiles (ICPs) from Customer Hunter. Use this when the user asks about their target customer, ideal customer, customer avatar, ICP, or who they should be selling to. Returns structured profiles including nightmare scenario, dream outcome, pain points, financial profile, an…

Update specific fields of a saved Ideal Customer Profile (ICP). Only modifies the fields you specify - all other data is preserved. To change the public audience label used in published copy, pass publicName in updates (the public-facing label — NEVER the internal persona name/codename); the intern…

Create a NEW Ideal Customer Profile (ICP) from scratch and save it — no Customer Hunter UI needed. Use this when get_icps returns hasICPs:false (the company has none yet) or to add another target customer profile. To CHANGE an existing ICP, use update_icp instead. Routing: Consult get_product_cont…

Publish THIS COMPANY'S hub site (only works for a company that has its own hub configured). CALL THIS when a hub change is ready to go live. Non-faith changes deploy now. New or changed faith/teaching words mint a card whose body IS the words — a person taps Publish once; those exact words then shi…

Tee up a ONE-CLICK publish card for THIS company's marketing site (Learn / SEO pages). Call after you opened a PR and took a browse_url screenshot of the preview. It NEVER publishes: it queues a Command Center card with the screenshot. The human taps Publish page to merge that frozen PR. If this co…

Capture an idea into the user's Ideas. Use when user shares an idea they want to save for later. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time. Call it on the first clear ask; the card is the yes…

List Ideas: untriaged (new/parked) for the operator, and/or triaged into the current company. Filter with status=new|parked|triaged|all (default all) and include_promoted for Ideas already promoted to a Playbook. Use when you need to see captured Ideas. Capture with capture_idea; assign with triage…

Assign an idea to one or more companies. Can identify by content snippet, ID, or "newest"/"latest". [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time. Call it on the first clear ask; the card is the…

List all content pipelines (changelogs, team updates, reports, customer newsletters, social posts). Use when user asks about their content automation, "what content am I publishing?", "show my pipelines", or "what outputs are configured". Output types: changelog (public product updates), team_updat…

Get CONTENT PIPELINE outputs waiting for approval/publish (changelogs, newsletters, social drafts). IDs are pipeline_outputs UUIDs — use approve_pipeline_item / publish_pipeline_item / request_content_revision. NOT Command Center decision cards — those use get_command_center_items + get_command_cen…

Create a new content pipeline to automate content creation. Use when user says "set up a changelog", "create a newsletter pipeline", "send team updates", "automate my X posts", or describes input→output automation. Output types: changelog (public product updates), team_update (internal team email v…

Update an existing content pipeline. Use when user says "rename my pipeline", "change the pipeline name", "update pipeline settings", or wants to modify pipeline configuration. Can update name, persona, ICPs, output type, or destination. [write-tier — first use may require a manager's approval; a…

Archive (or restore) a content pipeline — flips is_active off/on, mirroring the Content Pipeline UI's soft-delete/restore. No data is deleted or cascaded. Use when the user says "archive this pipeline", "pause my newsletter automation", "turn off this pipeline", or "bring back my archived pipeline"…

Submit manual content to a pipeline for transformation. Use when user says "add this to my changelog", "create a newsletter from this", "transform this content", "make social posts", "post to LinkedIn/Facebook/X", "give this to my team", or provides content to be processed — first clear ask, this t…

Approve a content item for publishing — or REJECT it with approved:false. Use when user says "approve it", "looks good", "publish that" (approve), or "reject it", "drop that duplicate", "don't publish" (approved:false). [sensitive-tier — first use may require a manager's approval; a from-now-on ap…

Request changes to a content item. Use when user says "revise this", "change the tone", "make it shorter", or provides feedback on pending content. The content will be re-transformed with their feedback. [write-tier — first use may require a manager's approval; a from-now-on approval makes future…

Publish approved INTERNAL content to configured output. ROUTING: team_update sends to all team members via FreedomOS, report sends to specified team member emails, customer_newsletter requires user Email MCP connection (Mailchimp, Resend, etc.), changelog publishes to public changelog page. ⚠️ SOCI…

Show the style guide and recent revision history for a content pipeline. Use when user asks "what are the learnings for my newsletter?", "show me the style guide", "what feedback have I given?", or "what does it know about my preferences?".

Manually add a style rule to a pipeline. Use when user says "always use bullet points", "never include hashtags", "keep it under 100 words", "use more casual tone", or gives general content preferences. [write-tier — first use may require a manager's approval; a from-now-on approval makes future c…

Track a personal commitment, deadline, birthday, appointment, or obligation. ALWAYS use this (not save_knowledge) when the user mentions: birthdays, due dates, deadlines, tax filings, events to plan, gifts to send, things they need to do by a certain date, or anything they want reminded about. Work…

List the user's active commitments. Shows what's on their plate across all life domains, sorted by due date.

Mark a commitment as completed. Use when the user says they finished something or a deadline has passed. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time. Call it on the first clear ask; the card is…

Update fields of an existing commitment — title, domain, due date, consequence, or description. Use when the user says "change the due date on...", "rename that commitment to...", "move X to next week", or otherwise edits something already tracked (not marking it done — use complete_commitment for…

Cancel a commitment without completing it — marks it cancelled. Use when the user says "cancel that", "never mind, drop it", or "that's not happening anymore" for something already tracked. For finished work, use complete_commitment instead. [write-tier — first use may require a manager's approval…

Get a cross-domain view of everything on the user's plate. Shows commitments from all life domains + promoted Playbooks across the portfolio, grouped by urgency. Use when the user asks "what should I focus on?", "what's on my plate?", "am I dropping anything?", or similar portfolio-level questions.

Share a commitment with your spouse or partner so they can see it too. Use when the user says "share this with my wife/husband" or "let [name] see this". [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next…

Stop sharing a commitment with someone. Removes their access. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time. Call it on the first clear ask; the card is the yes — do not re-ask in chat.]

Send a message to a Slack channel or direct message to a team member. Use when user asks to "message X on Slack", "send a Slack message", "DM someone on Slack", "post to #channel", etc. Routing: Confirm the message text and recipient/channel with the user before calling this — outbound and irrever…

Get the company's brand guidelines — name, tagline, colors, typography, personality/tone, naming rules, visual + positioning dos/donts. Call this before ANY operator-facing artifact: Plays, Focus copy, cards, images, banners, video, marketing. If you skip this, the brand page might as well not exis…

Update specific fields of the company's brand guidelines (visual identity, naming, positioning). Only modifies the fields you specify - all other data is preserved. Use when the user asks to change colors, tagline, typography, personality/tone, naming rules, or visual dos/donts. For changing how th…

Draft a first brand guide (personality tone, visual/positioning dos and donts) EXTRACTED from the company's own canon documents, with a verified receipt (quote + source doc) on every proposed item. Proposes only — never saves anything; the user reviews the receipts and accepts, then the accepted it…

Get the company's VOICE PROFILE plus reader-first rules and public audience labels for anyone writing operator-facing copy. Use when drafting Plays, Focus, Command Center cards, posts, captions, emails, or articles — this door loads that substrate every time. Do not rely on brand tone adjectives al…

Update the company's voice profile. Only modifies the fields you specify; all other data is preserved. Use when the operator wants to tune their voice — add/refine an in-voice DO or an out-of-voice AVOID, adjust the style descriptor, set a target reading level, or set whose voice it is. Routing: C…

Build or refresh the company's voice profile from REAL writing. Use this when the operator wants agents to learn their voice from their actual work — pass a URL to their blog / newsletter / posts (or an admired creator's page), or paste sample text. The system fetches it safely, distills the STYLE…

Get a person's OPERATOR FLUENCY (reader profile) — overall character level + per-topic strengths (novice/fluent/expert). Follows them across companies. Use before writing cards/FYIs so speech matches their level. Defaults to the caller; pass member_id for another person.

Update a person's OPERATOR FLUENCY (baseline + per-topic strengths that follow them across companies). Use when the operator (or an admin) sets or corrects how agents should speak to them, or when seeding an empty profile with seed_if_empty for a first guess. Human door for edits; agents may seed e…

Get a fluency INTERVIEW kit (domain candidates + "which is clearest?" protocol) so a host CoS can gauge how FO should talk to this operator. Use when onboarding, partner MCP connect, or speech feels too dumbed-down or too jargony. After human yes, call update_reader_profile — fluency follows them a…

Communicate asynchronously with the user. Use when they say post this / make social posts / give this to my team — first clear ask, this turn; the card is the yes (do not re-ask). Create a card in their Command Center ONLY when the user's judgment changes the outcome (a real decision they must make…

Browse a web page in a real browser and take a screenshot. Returns page content and a screenshot image. Use when you need to SEE what a page looks like (visual audit, brand check), interact with JavaScript-heavy pages, or capture visual evidence. The screenshot is returned as an image you can analy…

Save an artifact (screenshot, analysis, report) to the company archive. Use after browse_url to persist visual evidence, or to save any agent-produced artifact for future reference. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just…

Get saved artifacts for the company. Use to review past screenshots, analyses, and reports. Filters by artifact type, source URL, or agent.

Create a new Google Doc in the user's FreedomOS Drive folder. Use for JDs, deliverables, and shared documents. By default, creates beautifully formatted docs. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks…

Read content from an existing Google Doc by its ID. Routing: Load an agent JD, review a deliverable, or check shared memory state → use this with doc_id

Append new content to an existing Google Doc. Routing: Add learnings to agent memory, append to a deliverable, or update a JD → use this [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time. Call it on…

List files in the user's Google Drive. Can filter by type (spreadsheet, document) and search by name.

Create a new Google Spreadsheet with optional headers. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time. Call it on the first clear ask; the card is the yes — do not re-ask in chat.]

Read data from a Google Spreadsheet.

Append rows to a Google Spreadsheet. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time. Call it on the first clear ask; the card is the yes — do not re-ask in chat.]

Update specific cells in a Google Spreadsheet. [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time. Call it on the first clear ask; the card is the yes — do not re-ask in chat.]

Perform batch operations on a Google Spreadsheet (formatting, merging, etc.). [write-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time. Call it on the first clear ask; the card is the yes — do not re-ask in…

Audit whether FreedomOS appears in AI-generated search results. Sends a search query to external LLMs (Claude, Grok, Gemini, Perplexity) and checks each response for brand mentions. This is a competitive SEO/GEO auditing tool — like a mystery shopper for AI search engines. It does NOT answer questi…

Query event trends from PostHog (pageviews, signups, DAU, etc. over time). Returns time-series data. Only works if PostHog is connected.