Agent Task Recipes

Copy-paste workflows for high-confidence MCP usage.

These recipes are outcome-first and evidence-bound. Every recipe is valid against the same /mcp endpoint.

Back to agent guide JSON catalog Playground

Current Structural State

Get one evidence-bound structural snapshot suitable for dashboards and incident checks.

Tool: rootfetch.outcome.current_state

RPC request

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.current_state",
    "arguments": {}
  }
}

Open in playground

cURL

curl -sS https://rootfetch.com/mcp \
  -X POST \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"rootfetch.outcome.current_state","arguments":{}}}'

Expected top-level keys

outcome
schema_version
run_id
regime
concentration
coverage
volatility
top_anomalies
evidence

Verification checklist

evidence.run_id exists
evidence.manifest_sha256 exists
regime.state and regime.dvi_score exist

Latest Run Delta

Compare latest run vs previous run and detect structural movement with disclosure safety.

Tool: rootfetch.outcome.run_delta

RPC request

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.run_delta",
    "arguments": {}
  }
}

Open in playground

cURL

curl -sS https://rootfetch.com/mcp \
  -X POST \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"rootfetch.outcome.run_delta","arguments":{}}}'

Expected top-level keys

outcome
schema_version
left_run_id
right_run_id
transition
concentration_delta
coverage_delta
temporal
compare
evidence

Verification checklist

transition.model_changed is present
transition.model_transition_disclosure is honored when model_changed=true
compare.compare_url exists

TLD Spotlight

Get a strict evidence-bound view for one namespace.

Tool: rootfetch.outcome.tld_spotlight

RPC request

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.tld_spotlight",
    "arguments": {
      "tld": "app"
    }
  }
}

Open in playground

cURL

curl -sS https://rootfetch.com/mcp \
  -X POST \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"rootfetch.outcome.tld_spotlight","arguments":{"tld":"app"}}}'

Expected top-level keys

outcome
schema_version
run_id
tld
metrics
signals
links
evidence

Verification checklist

requested tld echoes in response.tld
links.run_url exists
evidence.manifest_sha256 exists

Alert Candidates

Pull top anomaly/mover candidates with trigger context for alert workflows.

Tool: rootfetch.outcome.alert_candidates

RPC request

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.alert_candidates",
    "arguments": {
      "limit": 10
    }
  }
}

Open in playground

cURL

curl -sS https://rootfetch.com/mcp \
  -X POST \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"rootfetch.outcome.alert_candidates","arguments":{"limit":10}}}'

Expected top-level keys

outcome
schema_version
run_id
limit
total_candidates
triggers
candidates
evidence

Verification checklist

candidates is an array
triggers include dvi_score and regime
evidence.run_id matches run_id

Regime Flip Bulletin Prep

Assemble a publish-ready payload when regime or DVI band moves materially.

Tool: rootfetch.outcome.run_delta

RPC request

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.run_delta",
    "arguments": {}
  }
}

Open in playground

cURL

curl -sS https://rootfetch.com/mcp \
  -X POST \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":6,"method":"tools/call","params":{"name":"rootfetch.outcome.run_delta","arguments":{}}}'

Expected top-level keys

outcome
left_run_id
right_run_id
transition
compare
evidence

Verification checklist

transition.regime_changed or |transition.dvi_delta| exceeds bulletin threshold
if transition.model_changed=true, include model transition disclosure
evidence.left.manifest_sha256 and evidence.right.manifest_sha256 exist

Publish template fields

run_pair
dvi_left_right_delta
regime_left_right
model_transition_disclosure
top_candidates_summary
compare_url
evidence_hashes

Workflow steps

Detect structural transition

Tool: rootfetch.outcome.run_delta

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.run_delta",
    "arguments": {}
  }
}

Open step in playground

Load current state context

Tool: rootfetch.outcome.current_state

{
  "jsonrpc": "2.0",
  "id": 8,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.current_state",
    "arguments": {}
  }
}

Open step in playground

Attach top candidate changes

Tool: rootfetch.outcome.alert_candidates

{
  "jsonrpc": "2.0",
  "id": 9,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.alert_candidates",
    "arguments": {
      "limit": 15
    }
  }
}

Open step in playground

Monthly Brief Payload

Build a compact monthly structural brief payload from strict outcome tools.

Tool: rootfetch.outcome.current_state

RPC request

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.current_state",
    "arguments": {}
  }
}

Open in playground

cURL

curl -sS https://rootfetch.com/mcp \
  -X POST \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":10,"method":"tools/call","params":{"name":"rootfetch.outcome.current_state","arguments":{}}}'

Expected top-level keys

outcome
run_id
regime
concentration
coverage
volatility
evidence

Verification checklist

coverage.counted_ever_count and coverage.approved_tlds_count are present
concentration.top10_share_pct and hhi are present
evidence.manifest_sha256 exists

Publish template fields

run_id
dvi_score_band
regime_state_confidence
top10_share_hhi
coverage_counts
7d_volatility
model_version
evidence_hash

Workflow steps

Current month-end state

Tool: rootfetch.outcome.current_state

{
  "jsonrpc": "2.0",
  "id": 11,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.current_state",
    "arguments": {}
  }
}

Open step in playground

Month-over-month delta (set run pair explicitly when needed)

Tool: rootfetch.outcome.run_delta

{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.run_delta",
    "arguments": {}
  }
}

Open step in playground

Top changes summary for brief appendix

Tool: rootfetch.outcome.alert_candidates

{
  "jsonrpc": "2.0",
  "id": 13,
  "method": "tools/call",
  "params": {
    "name": "rootfetch.outcome.alert_candidates",
    "arguments": {
      "limit": 25
    }
  }
}

Open step in playground