“BeeRad”
929423cb21
- align os MCP/runtime/docs with ra-h contract - add safe direct node lookup and context-optional flows - gate edge and context writes behind confirmation
2.4 KiB
2.4 KiB
Tools & Skills
MCP tools for graph operations and skills for procedural guidance.
How it works: External agents call MCP tools to read and write your graph. Contexts are optional soft organization only; node quality should come from clear nodes and explicit edges.
MCP Tools
RA-OS exposes these core standalone MCP tools:
Context + Graph
| Tool | Description |
|---|---|
getContext |
Graph overview: stats, contexts, hub nodes, recent activity, skills |
retrieveQueryContext |
Pull relevant graph context for a broader current-turn task |
queryNodes |
Find specific existing nodes by title, description, or source |
getNodesById |
Fetch full nodes by ID |
createNode |
Create a node |
writeContext |
Save one confirmed durable context node after explicit user approval |
updateNode |
Update a node while preserving context by default |
createEdge |
Create a confirmed edge between nodes |
queryEdge |
Query edges |
updateEdge |
Update an edge explanation after explicit confirmation |
queryContexts |
List contexts and optional attached nodes |
Skills + Search
| Tool | Description |
|---|---|
listSkills |
List available skills |
readSkill |
Read one skill |
writeSkill |
Create/update a skill |
deleteSkill |
Delete a skill |
searchContentEmbeddings |
Search source chunks/transcripts |
sqliteQuery |
Read-only SQL (SELECT, WITH, PRAGMA) |
Skills
Skills are markdown instructions stored locally and shared across internal + external agents.
Default seeded skills
db-operationscreate-skillaudittraverseonboardingpersonacalibrationconnect
Storage
- Live skills:
~/Library/Application Support/RA-H/skills/ - Bundled defaults:
src/config/skills/
API Routes
| Route | Method | Purpose |
|---|---|---|
/api/skills |
GET | List skills |
/api/skills/[name] |
GET/PUT/DELETE | Skill CRUD |
/api/guides |
GET | Compatibility alias to skills |
/api/guides/[name] |
GET/PUT/DELETE | Compatibility alias to skills |
Key Files
| File | Purpose |
|---|---|
apps/mcp-server-standalone/ |
Standalone MCP server (recommended) |
src/services/skills/skillService.ts |
Skills runtime service |
src/config/skills/*.md |
Bundled default skills |
src/components/panes/SkillsPane.tsx |
Skills pane UI |