API & MCP
Connect scripts, agents, Claude, ChatGPT, Gemini and Codex to this workspace.
Turned off in the demo
The MCP server, API tokens and OAuth connectors are closed here. The steps below show what you get on your own deployment, with your address in place of the example one.
Connect AI clients
- Open Settings → Connectors and choose Add custom connector.
- Paste this MCP server URL:
https://your-kano.example.com/mcp
- Complete the OAuth sign-in prompt. The connection appears below as OAuth: Claude.
For Claude Code CLI, create a personal token below and run the generated claude mcp add command.
Note: Remote OAuth connectors (claude.ai, ChatGPT, Gemini Enterprise) require a hosted deployment with a public https:// URL (KANO_AUTH=oauth and KANO_BASE_URL set).
Operations · 105
Each operation is exposed identically as a CLI command (kano op <name>), an MCP tool and a REST route (POST /api/ops/<name>) — see /api/openapi.json.
list_types— List registered artifact types with ID prefix, statuses, allowed link keys and body sections.get_schema— JSON Schema of an artifact type's frontmatter.list_artifacts— List artifacts from the index, filtered by type, status and any frontmatter field (where: {"links.goals": "G-002", horizon: "now"}).get_artifact— Read one artifact: frontmatter, body, derived fields, diagnostics and back-links.search_artifacts— Search the workspacefind_similar— Artifacts semantically close to one artifact (cosine similarity 0–1), e.gsuggest_links— ADR 0017: typed links an artifact is probably missing (both directions: links it should hold and links other artifacts should hold to it) and possible duplicates, from [[ID]] mentions, entity names, keywords and, with embeddings on, semantic neighbourscreate_artifact— Create an artifact with the next free ID and the type's templateupdate_artifact— Set frontmatter fields and/or replace the body or individual H2 sectionsreplace_file— Replace an artifact's whole Markdown file (frontmatter + body)link_artifacts— Add a typed link on the child side: from=INI-007 kind=goals to=G-002unlink_artifacts— Remove a typed link.delete_artifact— Delete an artifact that nothing links toget_graph— Nodes and edges around an artifact (goals ↔ initiatives ↔ opportunities ↔ feedback…).get_evidence— Feedback items and insights backing an initiative or opportunity, with unique-account ARR.validate— Check every file against its schema, link targets and ID uniquenessfix_workspace— Apply safe fixes (`kano validate --fix`): missing schema_version, status case, link ID formatting and duplicates, stored derived fieldsmigrate_workspace— Upgrade files to each type's current schema_version with the type's migrations (P3)get_config— kano.config.yaml as written (comments included), its parsed content and ConfigSchema as JSON Schema, for settings forms.update_config— Edit kano.config.yaml (ADR 0012): `set` dotted paths (agents.monthly_budget_usd, chat.model; null removes) as minimal YAML edits that keep comments, or replace the whole file with `yaml`get_context_pack— Compact Markdown bundle of vision, strategy, active goals, OKRs and personas to load before reasoning.ingest_feedback— Create a feedback item (FR-7.3)record_metric— Set a metric's current value and upsert the dated point in its history sidecar (FR-11.1).history— Git history of an artifact.list_reviews— Open review proposals (agent branches) with their changed files.get_review— One review proposal with its full diff.approve_review— Merge a proposal (all files, or only `files`)reject_review— Discard a proposal; the note is appended to the agent's memory file.whoami— The acting identity and role.list_users— Everyone who has signed in, with their role.set_user_role— Change a user's role: viewer, commenter, editor or admin.upsert_user_account— Create a local account or update a user's username, password, name and role.set_my_password— Set or change the current user's password and optional username.list_tokens— Your API tokens (admins: all tokens with all: true)create_token— Create a token for the REST API and MCP over HTTPcreate_share_link— A read-only link to the roadmap for stakeholders without an account (FR-4.4)list_share_links— Read-only share links, with when they were last viewed.revoke_share_link— Stop a share link from working.revoke_token— Revoke one of your tokens (admins: any token).list_secrets— API keys and connector credentials Kano knows about, grouped, with where each value comes from (env, vault or unset), who set it and whenset_secret— Store an API key or credential in the encrypted vault, outside git (ADR 0020)clear_secret— Remove a secret from the vaultaudit_strategy— Deterministic alignment checks: active goals with no initiative, initiatives with no goal, approved work without a PRD or evidence, live initiatives with no product (once products exist), stale bets, empty themes.check_delivery— Deterministic delivery checks on roadmap items: overdue, ending after their release target, starting before a dependency ends, missing dates, Now initiatives without items.list_action_items— Action items from meeting minutes (FR-12.2) across all meetings, with computed overdue flagsset_action_item— Mark a meeting action item done or open, or change its owner/due date (FR-12.2)add_action_item— Append an action item to a meeting's minutes (FR-12.2)audit_governance— Deterministic governance checks (FR-12.7): overdue action items, meetings held but not minuted, decisions proposed too long, accepted decisions without approvers, decisions past their review date.list_stakeholders— Internal stakeholders (FR-12.5) with role, influence/interest and counts of meetings attended, decisions approved, requests raised and open action items.capture_note— ADR 0019: save raw, unclassified text as a note (NOTE-xxxx) in the notes inbox: a thought, a to-do (use `- [ ]` lines), pasted meeting notesnote_todos— ADR 0019: checklist items (`- [ ]` / `- [x]`) across notes, open ones only unless all=trueset_note_todo— ADR 0019: mark checklist item `index` (from note_todos) of a note done or openaccept_note_suggestion— ADR 0019: accept triage suggestion `index` of a note: creates the feedback / decision (always proposed) / opportunity / insight / initiative, or for kind `link` relates the note to existing artifacts, and links the note to itdismiss_note_suggestion— ADR 0019: dismiss triage suggestion `index` of a note; it is kept as dismissed so triage does not offer it againroadmap_snapshot— Save a dated, committed copy of the strategic and operational roadmap (FR-4.5) for later comparison, e.glist_roadmap_snapshots— Saved roadmap snapshots, newest first.roadmap_diff— Changes between two roadmap states (FR-4.5): added/removed initiatives, horizon moves, status and quarter changes, delivery dates that slipped or were pulled inexport_roadmap— The roadmap as shareable Markdown (FR-4.4): narrative, Now/Next/Later by theme, quarters and upcoming releasesclose_the_loop— For a shipped initiative: list the customers whose feedback it addressed (by account, ARR, source link), write a close-the-loop report and mark those feedback items closedlist_comments— Comments on an artifact (FR-8.13): id, author, time, reply-to, resolved, text, @mentions.add_comment— Comment on an artifact, optionally replying to a comment (reply_to: c-…)resolve_comment— Mark a comment thread resolved (or reopen it).sync_status— State of the git remote sync (13.2): last sync, pulls, pushes, and any conflict with the branch that holds local work.sync_now— Commit pending edits, pull, merge and push now.list_agents— Agent definitions with status, model, triggers, next scheduled run and last run.run_agent— Queue a Kano agent run (optionally a dry run that merges nothing)list_runs— Agent runs, newest first: queued/running ones plus run records.get_run— One run: its record (summary, changes, log) or, while running, its live log.cancel_run— Cancel a queued or running agent runrevert_run— Revert every commit an agent run merged and discard its open proposal (P13).list_skills— Skills available to agents and Claude Code: name, description, origin, enabled, and whether a workspace copy overrides a built-in.get_skill— Full SKILL.md of a skill, frontmatter included.save_skill— Create or edit a skill's SKILL.mdreset_skill— Delete a workspace skillset_skill_enabled— Enable or disable a skill for Kano agents (kano.config.yaml skills.disabled)draft_agent— FR-10.4: describe what an agent should do in plain language; a meta-agent drafts its definition (instructions, skills, tools, triggers, scope), validated against what is installedcreate_agent— Create agents/<slug>/agent.md from a reviewed draft (from draft_agent)label_feedback— FR-7.3: give a feedback item a concise title, a category and a sentiment with the chat modelweave_artifact— ADR 0017: let the Weaver judge suggest_links candidates for an artifact with its model (weave.provider/model, else the agents default), add the links it is sure of (subject to path policy), propose the doubtful ones for review and comment on likely duplicatestriage_note— ADR 0019: read a raw note with the chat model and store suggestions on it: feedback, decisions, opportunities, insights or initiative ideas found in the text, linked to existing artifacts, or links to artifacts it is aboutrewrite_text— FR-8.12: rewrite text in an artifact so it follows the best-practice format of its type (a user story with acceptance criteria for a roadmap item, a measurable time-bound outcome for a goal, …)list_integrations— Connectors with their status: enabled, schedule, missing secrets, next run and last sync counts.integrations_overview— Everything the Integrations page shows, in one call (ADR 0020): each connector's status and Connect fields, its recent syncs, Google Chat's status, and for admins each connector's settings file and schematest_integration— Check a connector's credentials and config against the external system.connect_integration— Start the OAuth authorization code flow for a connector that needs consent (Zendesk): returns the provider URL to open in a browserfinish_connect_integration— Exchange the authorization code from the provider's redirect for tokens, store them outside git and test the connection.save_integration_credentials— Connect a connector from the UI (ADR 0020): settings such as base_url go in integrations/<id>.yaml (one commit), secrets such as API tokens in the encrypted vault outside gitdisconnect_integration— OAuth connectors: forget the stored tokens (the OAuth client stays)sync_integration— Pull from a connector now and apply its mapping (FR-11.1)integration_log— Recent syncs of a connector, newest first, with created/updated/skipped/errored counts and per-record errors.configure_integration— Enable/disable a connector or change its cron schedule in integrations/<id>.yaml (humans only).get_integration_config— integrations/<id>.yaml as written, the connector's settings from it, their JSON Schema (for generated forms), which env secrets are set (never their values) and any validation problem.update_integration_config— Edit a connector's settings in integrations/<id>.yaml (FR-11.1, ADR 0012), e.gimport_feedback_csv— Import feedback from CSV text with a column mapping (FR-11.5)google_chat_status— Whether the Google Chat app is configured: notification space, what it posts, feedback spaces.google_chat_test— Post a test message to the configured notification space.delivery_status— Which delivery tracker (delivery.tool: jira, linear, asana or none) links epics and stories, and whether its picker can search (integration connected).search_delivery_items— Typeahead over the delivery tracker (read-only, FR-3.7): kind=epic finds epics (for an initiative's jira_epic), kind=issue finds any epic, story or task (for a roadmap item's jira_key)jira_search— Search Jira issues with JQL (read-only)jira_get_issue— Read one Jira issue by key (read-only), with its description as plain text.posthog_query— Run a read-only HogQL query against PostHogposthog_get_insight— Read a saved PostHog insight by short ID: name, headline value and (trimmed) result.posthog_list_events— List event names defined in PostHog, optionally filtered by a search string.salesforce_soql— Run a read-only SOQL SELECT on allow-listed objects (Account, Opportunity, Case by default)zendesk_search— Search Zendesk tickets (read-only) with Zendesk search syntax, e.g