# create_research_routine

Create an explicitly confirmed one-shot or recurring research/reminder job. Results are retrieved by the user’s AI; host notifications require setup.

## Schedule a research routine

Create an explicitly confirmed one-shot or recurring research/reminder job. Results are retrieved by the user’s AI; host notifications require setup.



## Permission and calling convention

Required scope: monitors:write. This tool can change account-owned settings or prepare a request. Use only for an intentional user action.

This tool does not sign or broadcast a transaction. Check errors, source timestamps and explicit unavailable fields before using the result.



```
POST /api/tools/create_research_routine
Authorization: Bearer <ULTRON_ACCESS_KEY>
Content-Type: application/json
```

## Input schema

Inputs are validated against this current schema. Use exact values from live source results rather than substituting a ticker for a contract or a different chain.



```
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "kind": {
      "type": "string",
      "enum": [
        "market_cap_crossing",
        "market_leaders",
        "trench_watch",
        "token_pulse",
        "wallet_activity",
        "reminder"
      ]
    },
    "config": {
      "default": {},
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "firstRunAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "intervalMinutes": {
      "type": "integer",
      "minimum": 5,
      "maximum": 10080
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "confirm": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "name",
    "kind",
    "config",
    "firstRunAt",
    "confirm"
  ],
  "additionalProperties": false
}
```

## Continue building

Use the MCP tools/list response or /openapi.json for machine-readable discovery. For workflows and evidence boundaries, follow the appropriate guide.



[REST API](/docs/api) · [Builder quickstart](/docs/builders) · [Research workflow](/docs/trading-assistant)