titan_run_template

titan_run_template is the escape hatch. It runs an allowlisted Titan template directly, giving you access to template-specific payload fields and proxy location control that the dedicated tools do not surface. For most work, prefer titan_search, titan_fetch, or titan_crawl—they run the same templates with parameters shaped for agents. Required scope: mcp:templates:run

Parameters

string

required

Slug of an allowlisted template. Anything outside the allowlist returns template_not_found. List valid slugs with titan_list_templates.

string[]

Target URLs, up to 100. Required for templates that take static URLs, which is all eight current templates.

object

Template-specific options. Valid keys are defined by the template’s input_schema.

integer

Convenience shortcut merged into payload as max_results.

string[]

Geographic locations to route the run through. Useful when a target serves different content by region.

boolean

default:"true"

Wait for results inside the call.

integer

default:"30"

Seconds to wait, capped at 30.

string

Deduplicate repeated calls for 24 hours. See Idempotency and retries.

Example

Run the generic page extraction template with options the dedicated fetch tool does not expose:

{
  "template_slug": "generic-web-page-extraction-v1",
  "urls": ["https://example.com/pricing"],
  "payload": {
    "format": "markdown",
    "only_main_content": false,
    "include_image_links": false,
    "max_chars_per_url": 20000
  },
  "proxy_locations": ["de"]
}

Response

Records come back as raw template output rather than a tool-specific shape, because the shape is whatever the template’s output_schema defines.

{
  "run_id": "b4f18c27-3e95-4d60-a712-9f5c3e8b1d47",
  "status": "completed",
  "template": {
    "slug": "generic-web-page-extraction-v1",
    "name": "Generic Web Page Extraction",
    "category": "generic",
    "action_type": "scrape",
    "provider": "generic"
  },
  "records": [
    {
      "url": "https://example.com/pricing",
      "title": "Pricing",
      "status_code": 200,
      "content_format": "markdown",
      "content": "# Pricing\n\n## Starter\n$29/month...",
      "retrieved_at": "2026-07-27T09:44:18Z"
    }
  ],
  "usage": {
    "backend_execution_id": "b4f18c27-3e95-4d60-a712-9f5c3e8b1d47",
    "billing_unit": "successful_delivery",
    "records_returned": 1,
    "credits_estimated": 1,
    "credits_consumed": 1,
    "billing_status": "billable"
  },
  "warnings": [],
  "request_id": "req_9e4b2c7f1a3d8065"
}

The template object echoes which template ran, so an agent handling several templates can branch on it without tracking state.

Allowlist enforcement

Only the eight templates in the MCP allowlist are runnable. User-owned, admin, inactive, and experimental templates return:

{
  "code": "template_not_found",
  "message": "template \"my-private-template\" is not allowlisted for MCP",
  "retryable": false
}

This holds even if the same template is reachable through the Task Service API with your key. The allowlist is enforced at the MCP boundary, not by permission.

Credits

Credit estimates follow the template’s capability:

Capability	Estimate
`search`	1 credit per run
`fetch`	1 credit per URL
`crawl`	`max_results` when set, otherwise 1

Final billing is always based on records actually delivered. See Credits and usage.

When to use this instead of a dedicated tool

Situation	Tool
You need a `payload` field the dedicated tool does not expose	`titan_run_template`
You need `proxy_locations` to control request geography	`titan_run_template`
You want the friendliest parameters and normalized output	`titan_search` / `titan_fetch` / `titan_crawl`

Next steps

titan_list_templates — discover slugs and their schemas
titan_get_run — poll runs that outlive the wait window

Get started

Tool reference

How it works

Integration examples

Parameters

Example

Response

Allowlist enforcement

Credits

When to use this instead of a dedicated tool

Next steps

​Parameters

​Example

​Response

​Allowlist enforcement

​Credits

​When to use this instead of a dedicated tool

​Next steps

Parameters

Example

Response

Allowlist enforcement

Credits

When to use this instead of a dedicated tool

Next steps