Skip to content

MCP tools ​

The kernel is an MCP server at POST /mcp (JSON-RPC 2.0, Streamable HTTP with JSON responses, protocol revision 2025-06-18). Authenticate with an rk_… API token or an OIDC access token with the rangka.mcp scope. Claude, Omilo, Rangka AI or any MCP client can connect.

ToolArgumentsReturns
rangka_meta—The same as GET /api/v1/meta
rangka_get_filepath{path, kind, layer, text, parsed}
rangka_querymodel, filter?, sort?, limit? (1–500)Records
rangka_get_recordmodel, nameOne record
rangka_dashboardname, period?Computed widgets
rangka_system_status—The same as GET /api/v1/system/status
rangka_changeset_proposetitle, reason?, ops (create, replace, patch, delete on a change-set path)The change set, status: proposed, with risk and layers
rangka_changeset_validateidValidation result
rangka_changeset_previewidDry-run result
rangka_changeset_statusidCurrent state and history
rangka_catalogue—Every app, module and connector with its state for the site (installed, available, not_in_plan); per app the installed modules it shares and the modules it adds (contract 0035)
rangka_skills—Rangka skills for AI agents: {skills: [{name, description, source}]}
rangka_skillnameOne skill: {name, description, metadata, source, instructions, files}
rangka_skill_filename, pathOne file of a skill: {name, path, text}
rangka_approvals_liststate? (pending, approved, rejected, void), model?, name?Document approval requests, newest first, each with can_decide
rangka_approveid, decision (approve or reject), reason? (needed to reject)Decides a document approval. A person's browser session only: agent and API-token callers get human_required

Results come as content: [{type: "text", text: <json>}] plus structuredContent; errors set isError: true with {error: {code, message}}.

Tools follow the caller's model permissions, like REST.

There is deliberately no tool to approve or apply a change set: a person does that in the Console or the app. rangka_approve is for document approvals only (contract 0007). The embedded assistant Raka gets a narrower set: the read tools, the change-set tools up to preview, rangka_approvals_list, the catalogue and the skills; any other tool is refused with ai_forbidden.

The skills are the folders under skills/ plus each app's and module's skills/, in the Agent Skills format. Any harness can install them: see Skills.

Rangka OS is source-available under the Elastic License 2.0 (ELv2). Free to self-host.