# toggle_agent

Pause or resume an agent

Agent View of the PolicyLayer registry record for `toggle_agent`. HTML page: https://policylayer.com/tools/abcxz-conviction-fm/toggle-agent

## Facts

- Tool: `toggle_agent`
- Server: Conviction (`abcxz/conviction-fm`) — https://policylayer.com/tools/abcxz-conviction-fm.md
- Homepage: https://github.com/abcxz/conviction-fm
- Risk category: Execute (High risk)
- Registry record: grade D, identity unverified
- Server rate-limited: no
- Parameters: 0
- Recommended policy verdict: Rate-limited

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "toggle_agent",
    "arguments": {}
  }
}
```

## Why toggle_agent is rated High

Toggling an agent pauses or resumes its autonomous operation, including entering positions and capturing revenue from competition pools. While not directly moving money, it controls an agent that does, making it an Execute-level action with medium-to-high severity since misuse could halt a running strategy or resume a paused one unexpectedly.

From the tool's own definition: "'Pause or resume an agent' — triggers a state change in an external autonomous agent operating in a financial competition context"

## Use case

AI agents invoke toggle_agent to trigger actions in Conviction. What it does depends on the arguments the agent supplies, and its effects often reach beyond the immediate call: builds kicked off, notifications sent, workflows started.

## Recommended policy (PolicyLayer)

Verdict: **Rate-limited**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Conviction:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "toggle_agent": {
      "limits": [
        {
          "counter": "toggle_agent_rate",
          "window": "minute",
          "max": 10,
          "scope": "grant"
        }
      ]
    }
  }
}
```

## Other tools on Conviction (9)

- `create_agent` — Financial — https://policylayer.com/tools/abcxz-conviction-fm/create-agent.md
- `enter_position` — Financial — https://policylayer.com/tools/abcxz-conviction-fm/enter-position.md
- `export_wallet` — Financial — https://policylayer.com/tools/abcxz-conviction-fm/export-wallet.md
- `get_agent_status` — Read — https://policylayer.com/tools/abcxz-conviction-fm/get-agent-status.md
- `get_leaderboard` — Read — https://policylayer.com/tools/abcxz-conviction-fm/get-leaderboard.md
- `get_my_agents` — Read — https://policylayer.com/tools/abcxz-conviction-fm/get-my-agents.md
- `get_pool_history` — Read — https://policylayer.com/tools/abcxz-conviction-fm/get-pool-history.md
- `get_pools` — Read — https://policylayer.com/tools/abcxz-conviction-fm/get-pools.md
- `update_strategy` — Write — https://policylayer.com/tools/abcxz-conviction-fm/update-strategy.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=abcxz-conviction-fm · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/abcxz-conviction-fm