Skip to main content

MCP Tools

OpRelay exposes 30+ tools over the Model Context Protocol. Any MCP client auto-discovers them on connection.

Tool categories

Memory

ToolDescription
upsert_factCreate or update a project-scoped fact
get_factRead a single fact by key
list_fact_keysList keys, optionally filtered by category or pattern
list_categoriesList fact categories with counts
forget_factSoft-delete a fact
restore_factRestore a forgotten fact
get_contextBounded context retrieval — facts, decisions, runs
clear_contextSoft-clear all project memory
upsert_decisionCreate or update a decision

Tasks

ToolDescription
core_create_taskCreate a new task
core_get_taskGet task details by ID
core_list_tasksList tasks with filters
core_claim_taskClaim a task with lock
core_claim_and_start_taskClaim + transition to in_progress
core_transition_taskMove task to new status
core_update_taskUpdate assignment, priority, metadata
core_recover_taskForce-release stale locks
core_release_task_lockRelease lock without status change
post_task_messagePost to task side-channel
list_task_messagesRead task messages

Runs

ToolDescription
core_start_runBegin an execution run
core_end_runClose a run with status
core_report_usageReport token usage mid-run
core_record_failureRecord structured failure context
record_runAppend a run record

Agents & Infrastructure

ToolDescription
core_register_agentRegister or update agent metadata
core_get_agentGet agent state
list_projectsList all projects
healthDatabase health check
core_get_lane_configGet lane configuration
core_list_lane_configsList lane configs
core_upsert_lane_configCreate/update lane config

→ See individual tool pages for full parameter documentation.