AI agents: Read the dedicated AI agent guide first — routing table, execution rules, and session flow. This page covers dispatch-backed skills and opt-in personal tools.
arka_capabilitieslists the current MCP tools and dispatch-backed skills.arka_skillinvokes any dispatch command with a skill name and arguments.arka_routeaccepts natural language and routes it through Arka’s complete symbolic/fallback router.
arka_route as the umbrella MCP skill when a client is unsure which
specific Arka tool applies. Send the complete user request as prompt; do not
collapse it into a guessed skill name like design_from_screenshot or
web_answer.
This means newly added skills—including data collection, media transforms,
agent races, reusable blocks, ultra-fast development, OCR, RAG, and future
skills—do not need a separate MCP wrapper. Execution still passes through
Arka’s normal mode, security, and write-action gates.
Local-file MCP tools
arka_ocr and arka_rag are dedicated MCP tools for OCR and document RAG.
They only work when the agent can read paths on the local machine (for example
a Cursor workspace file). Cloud agents without mounted files cannot use them.
Call arka_capabilities to see the local_file_tools section, which lists
these tools and the shared notice agents should follow.
Incremental verification (all agents)
Do not wait for an entire long log or batch job before checking results.- Run the smallest useful demo first (one file, one page, or one sample).
- Inspect that result — enough output to confirm success or failure.
- If the first demo succeeds, run a second increment.
- Only then report the workflow as verified.
arka_capabilities exposes this under agent_execution_rules.incremental_verify.
Example MCP calls:
PDF_RAG_PGPT=auto skips PrivateGPT auto-start when TurboQuant
already indexed the file. Scanned PDFs are OCR’d locally before indexing. RAG ask
falls back to Ollama, then extractive context, if cloud LLM routes fail.
MCP also applies a safe default filter for personal desktop/device skills.
Spotify playback/search, Brave/browser-opening helpers, media playback, and
daily_brief are hidden or blocked unless the MCP server is started with
ARKA_MCP_ENABLE_PERSONAL_SKILLS=1 or a narrow
ARKA_MCP_ENABLED_TOOLS / ARKA_MCP_ENABLED_SKILLS override.
Routing cheat sheet
Full decision table and examples: AI agent guide.