-
Notifications
You must be signed in to change notification settings - Fork 3
MCP Tools Reference
ContextOS exposes 47 MCP-compatible tools across 5 categories. All tools follow the standard MCP schema and are compatible with any MCP client.
Store information with automatic tier assignment based on importance and recency.
{
"tool": "memory_store",
"input": {
"content": "string",
"tags": ["string"],
"scope": "user | agent | session",
"importance": 0.0-1.0,
"ttl_days": null
}
}Semantic search across all memory tiers.
{
"tool": "memory_retrieve",
"input": {
"query": "string",
"tiers": ["hot", "warm", "cold"],
"scope": "user | agent | all",
"limit": 10,
"min_score": 0.7
}
}Targeted forgetting with cascade to entity graph.
{
"tool": "memory_forget",
"input": {
"memory_id": "string",
"cascade_graph": true
}
}Compress a set of memories and promote the summary to the warm tier.
{
"tool": "memory_summarize",
"input": {
"memory_ids": ["string"],
"target_tier": "warm | cold",
"preserve_originals": false
}
}Compare two memory snapshots.
{
"tool": "memory_diff",
"input": {
"snapshot_a": "string",
"snapshot_b": "string"
}
}Query the entity relationship graph.
{
"tool": "memory_graph_query",
"input": {
"entity": "string",
"relationship": "string | null",
"depth": 2
}
}Export full memory state as JSON.
{
"tool": "memory_export",
"input": {
"scope": "user | agent | all",
"format": "json | markdown"
}
}Import / restore memory state.
{
"tool": "memory_import",
"input": {
"data": "string (JSON)",
"merge_strategy": "replace | merge | skip_conflicts"
}
}List and resolve conflicting memories.
{
"tool": "memory_conflicts",
"input": {
"auto_resolve": false,
"resolution_strategy": "newest | highest_confidence | manual"
}
}Hybrid search (BM25 + dense vector) across your document corpus.
{
"tool": "retrieve_docs",
"input": {
"query": "string",
"corpus": "internal | web | code | api | all",
"mode": "hybrid | bm25 | vector",
"limit": 10,
"staleness_check": true
}
}Fetch live documentation via context7 integration.
{
"tool": "retrieve_live",
"input": {
"library": "string",
"version": "string | latest",
"topic": "string"
}
}Web search with source quality scoring.
{
"tool": "retrieve_web",
"input": {
"query": "string",
"limit": 10,
"score_sources": true,
"max_age_days": null
}
}Codebase search with AST awareness.
{
"tool": "retrieve_code",
"input": {
"query": "string",
"language": "string | null",
"search_type": "semantic | exact | ast"
}
}Merge and deduplicate results from multiple corpora.
{
"tool": "retrieve_merge",
"input": {
"result_sets": ["array of retrieve results"],
"dedup_threshold": 0.9,
"ranking": "score | recency | provenance"
}
}Re-rank a set of results by provenance quality.
{
"tool": "retrieve_score",
"input": {
"results": ["array"],
"criteria": ["provenance", "recency", "relevance"]
}
}Log which retrieved results were actually used in final output.
{
"tool": "retrieve_feedback",
"input": {
"result_ids": ["string"],
"used": true,
"request_id": "string"
}
}Check content freshness and optionally trigger re-fetch.
{
"tool": "retrieve_staleness",
"input": {
"content_ids": ["string"],
"ttl_days": 30,
"auto_refresh": true
}
}Execute any registered tool.
{
"tool": "tool_run",
"input": {
"tool_name": "string",
"tool_version": "string | latest",
"parameters": {},
"use_cache": true
}
}Execute a DAG pipeline of tools.
{
"tool": "tool_chain",
"input": {
"pipeline": [
{
"id": "step_1",
"tool": "tool_name",
"parameters": {},
"depends_on": []
},
{
"id": "step_2",
"tool": "tool_name",
"parameters": { "input": "{{step_1.output}}" },
"depends_on": ["step_1"]
}
],
"on_failure": "stop | skip | fallback"
}
}Retrieve cached tool output.
{
"tool": "tool_cache_get",
"input": {
"tool_name": "string",
"parameters": {},
"max_age_seconds": 3600
}
}Manually cache a tool result.
{
"tool": "tool_cache_set",
"input": {
"tool_name": "string",
"parameters": {},
"result": {},
"ttl_seconds": 3600
}
}Register a new tool at runtime.
{
"tool": "tool_register",
"input": {
"name": "string",
"description": "string",
"schema": {},
"endpoint": "string",
"version": "string"
}
}List all available tools with versions.
{
"tool": "tool_list",
"input": {
"category": "memory | retrieval | execution | planning | orchestration | all",
"include_deprecated": false
}
}Get the schema for a specific tool.
{
"tool": "tool_schema",
"input": {
"tool_name": "string",
"version": "string | latest"
}
}Pin an agent workflow to a specific tool version.
{
"tool": "tool_version_pin",
"input": {
"tool_name": "string",
"version": "string",
"workflow_id": "string"
}
}Configure retry and fallback policy for a tool.
{
"tool": "tool_retry_policy",
"input": {
"tool_name": "string",
"max_retries": 3,
"retry_delay_ms": 1000,
"fallback_tool": "string | null",
"timeout_ms": 30000
}
}Estimate cost for a tool call before executing.
{
"tool": "tool_cost",
"input": {
"tool_name": "string",
"parameters": {}
}
}Execute code in a sandboxed environment.
{
"tool": "tool_sandbox_run",
"input": {
"code": "string",
"language": "python | javascript | bash",
"timeout_ms": 10000,
"capture_output": true
}
}Pass-through to Composio integration for 1000+ API tools.
{
"tool": "tool_composio",
"input": {
"app": "string",
"action": "string",
"parameters": {}
}
}Generate a spec-driven execution plan from a goal.
{
"tool": "plan_create",
"input": {
"goal": "string",
"context": "string",
"constraints": ["string"],
"template": "string | null"
}
}Revise a plan based on mid-execution feedback.
{
"tool": "plan_revise",
"input": {
"plan_id": "string",
"feedback": "string",
"failed_step": "string | null",
"propagate_constraints": true
}
}Compare two versions of a plan.
{
"tool": "plan_diff",
"input": {
"plan_id_a": "string",
"plan_id_b": "string"
}
}Score plan output against the original spec.
{
"tool": "plan_evaluate",
"input": {
"plan_id": "string",
"output": "string",
"criteria": ["completeness", "accuracy", "spec_adherence"]
}
}Run the Pre-Response Sparring Hook. See Pre-Response Sparring Hook.
{
"tool": "plan_spar",
"input": {
"request": "string",
"context": "string",
"prior_actions": ["string"]
}
}Break a goal into executable subtasks.
{
"tool": "plan_decompose",
"input": {
"goal": "string",
"max_steps": 10,
"style": "sequential | parallel | dag"
}
}Propagate constraint changes through a plan.
{
"tool": "plan_constraints",
"input": {
"plan_id": "string",
"constraint_change": "string",
"affected_step": "string"
}
}Restore a previous plan version.
{
"tool": "plan_rollback",
"input": {
"plan_id": "string",
"target_version": "string | previous"
}
}Load a proven spec template.
{
"tool": "plan_template",
"input": {
"template_name": "string",
"variables": {}
}
}Classify and route an incoming request.
{
"tool": "ctx_route",
"input": {
"request": "string",
"context": "string"
}
}Get full trace for a request ID.
{
"tool": "ctx_trace",
"input": {
"trace_id": "string",
"include_costs": true
}
}Get a registered tool schema.
{
"tool": "ctx_schema_get",
"input": {
"tool_name": "string",
"version": "string | latest"
}
}Register a new tool schema.
{
"tool": "ctx_schema_register",
"input": {
"name": "string",
"schema": {},
"version": "string"
}
}Get cost ledger summary.
{
"tool": "ctx_cost_summary",
"input": {
"workspace": "string",
"period": "session | day | week | month | all"
}
}Create a new isolated workspace.
{
"tool": "ctx_workspace_create",
"input": {
"name": "string",
"config": {}
}
}List all workspaces.
{
"tool": "ctx_workspace_list",
"input": {}
}System health check.
{
"tool": "ctx_health",
"input": {
"layers": ["memory", "retrieval", "tools", "planning", "orchestration"]
}
}Get ContextOS version and component info.
{
"tool": "ctx_version",
"input": {}
}