{
  "schemaVersion": "2026-07-28",
  "provider": "Vitna",
  "servers": [
    {
      "name": "vitna-mcp",
      "title": "Vitna Market Record & Engine MCP",
      "version": "1.0.0",
      "endpoint": "https://vitna.ai/api/v1/mcp",
      "transport": "streamable-http",
      "protocolVersions": [
        "2025-03-26"
      ],
      "authentication": {
        "type": "none"
      },
      "docs": "https://vitna.ai/mcp",
      "tools": [
        {
          "name": "vitna_check_quote",
          "description": "Evaluate a vendor AI pricing quote in memory against Witness list prices and peer spreads with zero retention.",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "sku": {
                "type": "string",
                "description": "Witness SKU slug or provider/slug (for example, gpt-5.4)."
              },
              "quotedAmountUsd": {
                "type": "number",
                "description": "Quoted rate in the meter's USD unit."
              },
              "dimension": {
                "type": "string",
                "description": "Optional meter dimension (for example, input_per_mtok)."
              },
              "date": {
                "type": "string",
                "description": "Optional historical ISO date YYYY-MM-DD."
              },
              "promptTokens": {
                "type": "integer",
                "minimum": 0,
                "description": "Optional prompt length in tokens of the requests the quote covers. On a model priced in context bands it picks the band compared; without it the band from the first token is compared."
              }
            },
            "required": [
              "sku",
              "quotedAmountUsd"
            ]
          }
        },
        {
          "name": "vitna_get_market_tape",
          "description": "Read current first-party attested list prices from the Witness market tape, optionally filtered to one component class and provider.",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "class": {
                "type": "string",
                "description": "Optional component class (model, gpu, retrieval, speech, tool, image, video, music). Omit for the market overview."
              },
              "provider": {
                "type": "string",
                "description": "Optional provider id filter (for example, openai, anthropic)."
              }
            }
          }
        },
        {
          "name": "vitna_get_sku_history",
          "description": "Retrieve the append-only price period history for a Witness SKU, optionally narrowed to a single price dimension.",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "slug": {
                "type": "string",
                "description": "Witness SKU slug (for example, gpt-5.4 or h100-sxm)."
              },
              "dimension": {
                "type": "string",
                "description": "Optional price dimension id (for example, input_per_mtok)."
              }
            },
            "required": [
              "slug"
            ]
          }
        },
        {
          "name": "vitna_get_provider_terms",
          "description": "Inspect curated, source-verified provider data handling terms (zero_retention, no_training, regions, byok).",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "provider": {
                "type": "string",
                "description": "Optional provider id (for example, anthropic, openai)."
              },
              "kind": {
                "type": "string",
                "enum": [
                  "zero_retention",
                  "no_training",
                  "regions",
                  "byok"
                ],
                "description": "Optional term kind filter."
              }
            }
          }
        },
        {
          "name": "vitna_cite_observation",
          "description": "Resolve a Witness observation id into its archived document SHA-256, Ed25519 signed-day status, and copy-ready citations.",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": [
                  "integer",
                  "string"
                ],
                "description": "Numeric Witness observation id."
              }
            },
            "required": [
              "id"
            ]
          }
        },
        {
          "name": "vitna_get_sku_capabilities",
          "description": "Inspect a Witness SKU's three-provenance capability profile: mirrored catalog capabilities and context length, third-party speed and TTFT measurements, curated provider terms, and admissibility boundaries.",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "slug": {
                "type": "string",
                "description": "Witness SKU slug or provider/slug (for example, claude-sonnet-4-6 or gpt-5.4)."
              }
            },
            "required": [
              "slug"
            ]
          }
        },
        {
          "name": "vitna_decide_stack",
          "description": "Run a stateless, zero-retention stack migration check comparing candidate SKUs against an incumbent SKU, compliance requirements, three-provenance capability and speed bounds, and inline eval scores.",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "workload": {
                "type": "object",
                "description": "Workload profile including incumbentSkuId, unitProfile, monthlyVolume, priority, and constraints (qualityFloor, economicThresholdPct, compliance terms, requiresCapabilities, requiresVerifiedCapabilities, minContextTokens, minThroughputToksSec, maxTtftMs).",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "incumbentSkuId": {
                    "type": "string"
                  },
                  "unitProfile": {
                    "type": "object"
                  },
                  "monthlyVolume": {
                    "type": "number"
                  },
                  "priority": {
                    "type": "string"
                  },
                  "constraints": {
                    "type": "object"
                  }
                },
                "required": [
                  "incumbentSkuId"
                ]
              },
              "candidates": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Candidate SKU ids or slugs to evaluate."
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Inline evaluation measurements per SKU (successRatePct, edgeCaseFailures, latencyP90Ms, and customer verifiedCapabilities with n and sourceRef)."
              }
            },
            "required": [
              "workload",
              "candidates"
            ]
          }
        },
        {
          "name": "vitna_check_rollout",
          "description": "Evaluate standing-decision drift, shadow rule promotion readiness, and routed canary health in memory against Witness list prices, compliance terms, three-provenance capabilities, and inline runtime telemetry with zero retention.",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "workload": {
                "type": "object",
                "description": "Workload profile including incumbentSkuId, unitProfile, monthlyVolume, and constraints (qualityFloor, latencyP90Ms, compliance terms, capability bounds).",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "incumbentSkuId": {
                    "type": "string"
                  },
                  "unitProfile": {
                    "type": "object"
                  },
                  "monthlyVolume": {
                    "type": "number"
                  },
                  "constraints": {
                    "type": "object"
                  }
                },
                "required": [
                  "incumbentSkuId"
                ]
              },
              "standingDecision": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Optional standing decision metadata (id, outcome, candidateSkuId, decidedAt, recordedUnitCostUsd)."
              },
              "rules": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Active shadow or route lane rules to evaluate on the canary ladder (id, position, mode, kind, share, threshold, serveSkuId)."
              },
              "ledgerRows": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional runtime JSONL ledger rows carrying outcome, serve, shadowRule, cohort, and latencyMs."
              },
              "observations": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional aggregated deployment observation rows (skuId, units, primaryServes, fallbackServes, ruleServes, failed, refused, latencyP95Ms)."
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional evaluation measurements per SKU (successRatePct, edgeCaseFailures, latencyP90Ms, verifiedCapabilities)."
              },
              "thresholds": {
                "type": "object",
                "description": "Optional watchdog threshold overrides (minShadowMatches, minCanaryUnits, maxUnservedRatePct, maxFallbackSharePct, maxPriceDriftPct)."
              }
            },
            "required": [
              "workload"
            ]
          }
        },
        {
          "name": "vitna_analyze_pipeline",
          "description": "Compute a compound multi-stage AI pipeline Bill of Materials, per-run trace attribution, compound reliability, and cross-layer spend optimization across all 10 Witness component classes (model, compute, retrieval, speech, tooling, extraction, translation, image, video, music) with zero retention.",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Human-readable pipeline name."
              },
              "runLabel": {
                "type": "string",
                "description": "Plural unit of one pipeline execution, e.g. reports, sessions, invoices."
              },
              "monthlyRuns": {
                "type": "integer",
                "description": "Optional monthly pipeline execution volume."
              },
              "discoverPeers": {
                "type": "boolean",
                "description": "When true, automatically scan active Witness class peers on every stage for eligible lower-cost exploratory levers."
              },
              "stages": {
                "type": "array",
                "description": "Ordered stages in the compound pipeline, each naming an incumbentSkuId, unitProfile, and invocationsPerRun.",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "classId": {
                      "type": "string"
                    },
                    "incumbentSkuId": {
                      "type": "string"
                    },
                    "invocationsPerRun": {
                      "type": "number"
                    },
                    "criticalPath": {
                      "type": "boolean"
                    },
                    "unitProfile": {
                      "type": "object"
                    },
                    "constraints": {
                      "type": "object"
                    },
                    "candidates": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "incumbentSkuId"
                  ]
                }
              },
              "privateRates": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional customer-entered rates for internal infrastructure SKUs (skuId, dimensionId, amountUsd, classId)."
              },
              "ledgerRows": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional runtime JSONL rows carrying runId (x-vitna-run) and lane for empirical fan-out attribution."
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional evaluation measurements per SKU or stage (successRatePct, edgeCaseFailures, latencyP90Ms, verifiedCapabilities)."
              }
            },
            "required": [
              "stages"
            ]
          }
        },
        {
          "name": "vitna_verify_audit_pack",
          "description": "Verify a cryptographic vitna.audit-pack.v1 procurement, FinOps, and governance attestation pack across all six layers, or assemble an inline audit pack from a Stackfile with zero retention.",
          "annotations": {
            "readOnlyHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "verify",
                  "assemble"
                ],
                "description": "Optional explicit mode: verify an existing pack or assemble one from stackfile."
              },
              "pack": {
                "type": "object",
                "description": "A vitna.audit-pack.v1 JSON document to verify in memory."
              },
              "stackfile": {
                "type": "object",
                "description": "A vitna.stackfile.v1 JSON document for zero-retention inline pack assembly."
              },
              "trustedPackPublicKey": {
                "type": "string",
                "description": "Optional pinned Ed25519 SPKI public key (base64 or PEM) for the outer pack signature."
              },
              "trustedRecordPublicKey": {
                "type": "string",
                "description": "Optional pinned Ed25519 SPKI public key for Witness daily Merkle root attestations."
              },
              "trustedPolicyPublicKey": {
                "type": "string",
                "description": "Optional pinned Ed25519 SPKI public key for signed routing policy envelopes."
              },
              "requirePackSignature": {
                "type": "boolean",
                "description": "When true, fail verification if the outer pack is unsigned."
              },
              "requireAttestedPrices": {
                "type": "boolean",
                "description": "When true, fail verification if any cited Witness price observation lacks a signed daily Merkle root."
              },
              "failOnRollback": {
                "type": "boolean",
                "description": "When true, fail verification if the rollout watchdog verdict is rollback_recommended."
              },
              "maxMonthlyCostUsd": {
                "type": "number",
                "description": "Optional maximum total estimated monthly pipeline spend gate in USD."
              },
              "monthlyRuns": {
                "type": "integer",
                "description": "Optional monthly pipeline execution count when assembling from a Stackfile."
              },
              "discoverPeers": {
                "type": "boolean",
                "description": "When true in assemble mode, scan active Witness class peers for exploratory spend levers."
              },
              "policyText": {
                "type": "string",
                "description": "Optional signed policy.json envelope string to bind in assemble mode."
              },
              "policyLock": {
                "type": "object",
                "description": "Optional vitna.lock.json object to bind in assemble mode."
              },
              "ledgerRows": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional runtime JSONL rows for rollout watchdog and trace attribution in assemble mode."
              },
              "evidence": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional workload evaluation rows in assemble mode."
              },
              "terms": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional provider compliance term rows in assemble mode."
              }
            }
          }
        }
      ]
    },
    {
      "name": "vitna-web",
      "title": "Vitna Web API & Official Sources MCP",
      "version": "alpha",
      "endpoint": "https://web.vitna.ai/v1/mcp",
      "transport": "streamable-http",
      "protocolVersions": [
        "2026-07-28",
        "2025-11-25",
        "2025-06-18",
        "2025-03-26"
      ],
      "stateless": true,
      "authentication": {
        "type": "bearer",
        "scheme": "Bearer",
        "header": "Authorization",
        "keyPrefixes": [
          "vitna_web_",
          "vitna_key_"
        ],
        "requestAccessUrl": "https://vitna.ai/start#web"
      },
      "docs": "https://vitna.ai/apis",
      "manifest": "https://web.vitna.ai/.well-known/mcp.json",
      "tools": [
        {
          "name": "find_sources",
          "title": "Find a data source",
          "description": "Find official data sources (federal agencies and registries) for a task, such as federal contract awards, drug recalls, a company's SEC filings, clinical trials or regulation text. Returns the best-matching capabilities, each with the input schema run_source holds its options to and a working example. Free.",
          "needs": "sources",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "What you are looking for, in plain words."
              },
              "category": {
                "type": "string",
                "enum": [
                  "government",
                  "finance",
                  "health"
                ]
              },
              "provider": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9-]{1,40}$",
                "description": "A provider id, such as openfda."
              },
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20,
                "default": 5
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "describe_source",
          "title": "Read a data source's contracts",
          "description": "The full contract of one provider's capabilities, or of one capability: input and output schemas, price, availability, and the license, attribution and notices its data comes with. Free.",
          "needs": "sources",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "provider": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9-]{1,40}$",
                "description": "A provider id, such as openfda."
              },
              "capability": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9-]*(?:/[a-z][a-z0-9-]*){0,2}$",
                "description": "A capability id, such as recalls/search."
              }
            },
            "required": [
              "provider"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "run_source",
          "title": "Call a data source",
          "description": "Call one capability of an official data source and get its data with the source it came from: the upstream URL, retrieval time, license, attribution and notices to show with it. options must satisfy the capability's input schema from find_sources or describe_source. Each call that returns data is metered.",
          "needs": "sources",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "provider": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9-]{1,40}$",
                "description": "A provider id, such as openfda."
              },
              "capability": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9-]*(?:/[a-z][a-z0-9-]*){0,2}$",
                "description": "A capability id, such as recalls/search."
              },
              "options": {
                "type": "object",
                "additionalProperties": true,
                "description": "The capability's options, as its input schema describes them."
              }
            },
            "required": [
              "provider",
              "capability"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "read_page",
          "title": "Read a web page",
          "description": "Read one public web page, rendered in a browser, as markdown or plain text, with its title and links, plus optional DOM filtering (onlyMainContent, includeTags, excludeTags), highlights, page-grounded question answering, inline extraction, prompt-injection scan, and PII redaction. content is cut at maxCharacters (20,000 unless given); truncated says whether it was. Counts as a page read.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "A public HTTPS URL."
              },
              "format": {
                "type": "string",
                "enum": [
                  "markdown",
                  "text"
                ],
                "default": "markdown"
              },
              "maxCharacters": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100000,
                "default": 20000
              },
              "render": {
                "type": "boolean",
                "default": true,
                "description": "Render the page in a browser before reading it. false reads the HTML as served."
              },
              "onlyMainContent": {
                "type": "boolean",
                "description": "Extract only the main content (true by default); false keeps header, nav, aside, and footer chrome."
              },
              "includeTags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Keep only elements matching these CSS selectors (1 to 20)."
              },
              "excludeTags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Omit elements matching these CSS selectors (1 to 20)."
              },
              "extract": {
                "type": "object",
                "properties": {
                  "selectors": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Field names mapped to CSS selectors or { selector, attribute }."
                  },
                  "schema": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "A JSON Schema object for extracted data."
                  },
                  "prompt": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 10000,
                    "description": "Plain-language extraction instruction (needs a configured language model)."
                  }
                },
                "required": [],
                "additionalProperties": false,
                "description": "Extract structured fields from the rendered page."
              },
              "highlights": {
                "type": [
                  "boolean",
                  "object"
                ],
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Select verbatim passages relevant to this query."
                  },
                  "maxCharacters": {
                    "type": "integer",
                    "minimum": 100,
                    "maximum": 4000,
                    "description": "Character budget for highlights (1,000 unless given)."
                  }
                },
                "additionalProperties": false,
                "description": "Return ranked verbatim passages from the page: true for up to 1,000 characters, or an object with query and maxCharacters."
              },
              "question": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Answer one question grounded in the rendered page."
              },
              "injection": {
                "type": "string",
                "enum": [
                  "scan",
                  "strip"
                ],
                "description": "scan reports prompt-injection patterns; strip also removes invisible characters from content."
              },
              "redact": {
                "type": [
                  "boolean",
                  "array"
                ],
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "phone",
                    "card",
                    "iban",
                    "ssn",
                    "ip"
                  ]
                },
                "minItems": 1,
                "maxItems": 6,
                "description": "true redacts all supported personal-data kinds; a list redacts only those kinds."
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "batch_scrape",
          "title": "Read multiple web pages",
          "description": "Read up to 20 public HTTPS URLs in one call as markdown or plain text, with optional per-page DOM filtering, highlights, question answering, inline extraction, prompt-injection scan, and PII redaction. Per-URL failures are isolated in errors while successful pages stay in pages. Each URL counts as a page read.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "urls": {
                "type": "array",
                "items": {
                  "type": "string",
                  "format": "uri",
                  "minLength": 8,
                  "maxLength": 4096,
                  "description": "A public HTTPS URL."
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Between 1 and 20 public HTTPS URLs to read."
              },
              "format": {
                "type": "string",
                "enum": [
                  "markdown",
                  "text"
                ],
                "default": "markdown"
              },
              "maxCharacters": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100000,
                "default": 20000
              },
              "render": {
                "type": "boolean",
                "default": true,
                "description": "Render pages in a browser before reading them."
              },
              "onlyMainContent": {
                "type": "boolean",
                "description": "Extract only the main content (true by default); false keeps header, nav, aside, and footer chrome."
              },
              "includeTags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Keep only elements matching these CSS selectors (1 to 20)."
              },
              "excludeTags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Omit elements matching these CSS selectors (1 to 20)."
              },
              "extract": {
                "type": "object",
                "properties": {
                  "selectors": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Field names mapped to CSS selectors or { selector, attribute }."
                  },
                  "schema": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "A JSON Schema object for extracted data."
                  },
                  "prompt": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 10000,
                    "description": "Plain-language extraction instruction (needs a configured language model)."
                  }
                },
                "required": [],
                "additionalProperties": false,
                "description": "Extract structured fields from the rendered page."
              },
              "highlights": {
                "type": [
                  "boolean",
                  "object"
                ],
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Select verbatim passages relevant to this query."
                  },
                  "maxCharacters": {
                    "type": "integer",
                    "minimum": 100,
                    "maximum": 4000,
                    "description": "Character budget for highlights (1,000 unless given)."
                  }
                },
                "additionalProperties": false,
                "description": "Return ranked verbatim passages from the page: true for up to 1,000 characters, or an object with query and maxCharacters."
              },
              "question": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Answer one question grounded in the rendered page."
              },
              "injection": {
                "type": "string",
                "enum": [
                  "scan",
                  "strip"
                ],
                "description": "scan reports prompt-injection patterns; strip also removes invisible characters from content."
              },
              "redact": {
                "type": [
                  "boolean",
                  "array"
                ],
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "phone",
                    "card",
                    "iban",
                    "ssn",
                    "ip"
                  ]
                },
                "minItems": 1,
                "maxItems": 6,
                "description": "true redacts all supported personal-data kinds; a list redacts only those kinds."
              }
            },
            "required": [
              "urls"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "extract_data",
          "title": "Extract data from pages",
          "description": "Pull fields out of one page, up to 20 pages, or the pages discovered from a starting URL: give CSS selectors for fields you can point at, a JSON Schema for the result you want (filled from the pages' published structured data and stated facts), plain-language instructions in prompt where the server has a language model, or the id of a saved recipe. Waits for the result; each page counts as a page read.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "One page, or the starting page when maxPages is above 1. Give url or urls."
              },
              "urls": {
                "type": "array",
                "items": {
                  "type": "string",
                  "format": "uri",
                  "minLength": 8,
                  "maxLength": 4096,
                  "description": "A public HTTPS URL."
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Several pages combined into one result."
              },
              "selectors": {
                "type": "object",
                "additionalProperties": true,
                "description": "Field names mapped to CSS selectors, such as { \"price\": \".price\" }, or to { selector, attribute } to read an attribute."
              },
              "schema": {
                "type": "object",
                "additionalProperties": true,
                "description": "A JSON Schema object for the result: object, array, string, number, integer and boolean types, nullable unions, properties, required, items and enum."
              },
              "prompt": {
                "type": "string",
                "minLength": 1,
                "maxLength": 10000,
                "description": "What to extract, in plain words, such as List every board member with their role. Needs a language model on the server; with a schema, it guides how the schema is filled."
              },
              "recipe": {
                "type": "string",
                "pattern": "^[A-Za-z0-9-]{1,64}$",
                "description": "The id of a saved extraction recipe."
              },
              "maxPages": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20,
                "description": "Pages to discover and read from url (1 unless given)."
              },
              "includePaths": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "When discovering pages, keep only paths containing one of these."
              },
              "excludePaths": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "When discovering pages, drop paths containing one of these."
              },
              "render": {
                "type": "boolean",
                "description": "Render pages in a browser first (true unless given)."
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "map_site",
          "title": "List a site's URLs",
          "description": "The URLs of a site, found from its links and optionally its sitemaps, within the starting host unless asked otherwise. Returns URLs without reading their content; use read_page or crawl_site for that.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "Where discovery starts; its host bounds the map."
              },
              "maxPages": {
                "type": "integer",
                "minimum": 1,
                "maximum": 1000,
                "description": "URLs to return at most (50 unless given)."
              },
              "includePaths": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Keep only URLs whose path contains one of these, such as /docs/."
              },
              "excludePaths": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Drop URLs whose path contains one of these; excludes win."
              },
              "maxDepth": {
                "type": "integer",
                "minimum": 0,
                "maximum": 20,
                "description": "Links followed from the starting page."
              },
              "sitemap": {
                "type": "string",
                "enum": [
                  "skip",
                  "include",
                  "only"
                ],
                "description": "Read the site's sitemaps as well as its links (include), or instead of them (only)."
              },
              "includeSubdomains": {
                "type": "boolean",
                "description": "Follow links to subdomains of the starting host."
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "crawl_site",
          "title": "Crawl a site",
          "description": "Start a background crawl that reads a site's pages as markdown or text (with optional per-page DOM filtering, extract, highlights, question, injection scan, and redaction) and returns its job id at once. Read progress and pages with get_crawl, and stop it with cancel_crawl. Reads up to 25 pages of 20,000 characters each, for up to 5 minutes, unless asked otherwise. Each page counts as a page read. Up to 20 crawls are kept per key; the oldest finished ones are removed to admit new ones.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": false,
            "destructiveHint": false,
            "idempotentHint": false,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "Where the crawl starts; its host bounds the crawl."
              },
              "maxPages": {
                "type": "integer",
                "minimum": 1,
                "maximum": 500,
                "default": 25
              },
              "includePaths": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Keep only URLs whose path contains one of these, such as /docs/."
              },
              "excludePaths": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Drop URLs whose path contains one of these; excludes win."
              },
              "maxDepth": {
                "type": "integer",
                "minimum": 0,
                "maximum": 20,
                "description": "Links followed from the starting page."
              },
              "sitemap": {
                "type": "string",
                "enum": [
                  "skip",
                  "include",
                  "only"
                ],
                "description": "Read the site's sitemaps as well as its links (include), or instead of them (only)."
              },
              "includeSubdomains": {
                "type": "boolean",
                "description": "Follow links to subdomains of the starting host."
              },
              "format": {
                "type": "string",
                "enum": [
                  "markdown",
                  "text"
                ],
                "default": "markdown"
              },
              "maxCharacters": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100000,
                "default": 20000,
                "description": "Characters kept from each page."
              },
              "jobTimeoutMs": {
                "type": "integer",
                "minimum": 1000,
                "maximum": 600000,
                "default": 300000,
                "description": "How long the whole crawl may run."
              },
              "onlyMainContent": {
                "type": "boolean",
                "description": "Extract only the main content (true by default); false keeps header, nav, aside, and footer chrome."
              },
              "includeTags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Keep only elements matching these CSS selectors (1 to 20)."
              },
              "excludeTags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Omit elements matching these CSS selectors (1 to 20)."
              },
              "extract": {
                "type": "object",
                "properties": {
                  "selectors": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "Field names mapped to CSS selectors or { selector, attribute }."
                  },
                  "schema": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "A JSON Schema object for extracted data."
                  },
                  "prompt": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 10000,
                    "description": "Plain-language extraction instruction (needs a configured language model)."
                  }
                },
                "required": [],
                "additionalProperties": false,
                "description": "Extract structured fields from the rendered page."
              },
              "highlights": {
                "type": [
                  "boolean",
                  "object"
                ],
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Select verbatim passages relevant to this query."
                  },
                  "maxCharacters": {
                    "type": "integer",
                    "minimum": 100,
                    "maximum": 4000,
                    "description": "Character budget for highlights (1,000 unless given)."
                  }
                },
                "additionalProperties": false,
                "description": "Return ranked verbatim passages from the page: true for up to 1,000 characters, or an object with query and maxCharacters."
              },
              "question": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "Answer one question grounded in the rendered page."
              },
              "injection": {
                "type": "string",
                "enum": [
                  "scan",
                  "strip"
                ],
                "description": "scan reports prompt-injection patterns; strip also removes invisible characters from content."
              },
              "redact": {
                "type": [
                  "boolean",
                  "array"
                ],
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "phone",
                    "card",
                    "iban",
                    "ssn",
                    "ip"
                  ]
                },
                "minItems": 1,
                "maxItems": 6,
                "description": "true redacts all supported personal-data kinds; a list redacts only those kinds."
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "get_crawl",
          "title": "Read a crawl's progress and pages",
          "description": "A crawl's status and a slice of its pages: 25 at a time from offset, as URLs and titles unless includeContent asks for their text. pagination.nextOffset gives the next slice. Free.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "The id crawl_site returned."
              },
              "offset": {
                "type": "integer",
                "minimum": 0,
                "maximum": 500,
                "default": 0
              },
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100,
                "default": 25
              },
              "includeContent": {
                "type": "boolean",
                "default": false,
                "description": "Include each page's text. Ask for few pages at a time."
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "cancel_crawl",
          "title": "Stop a crawl",
          "description": "Stop a queued or running crawl. Pages it has already read stay readable with get_crawl.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": false,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": false
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{1,64}$",
                "description": "The id crawl_site returned."
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "research_web",
          "title": "Research a question across web pages",
          "description": "Run bounded multi-page research across search hits or supplied seed URLs, optionally following query-relevant links (followLinks) and returning a cited answer or structured JSON matching schema. Synchronous within the call budget; each page read counts as a page read.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "The question or research goal to investigate."
              },
              "urls": {
                "type": "array",
                "items": {
                  "type": "string",
                  "format": "uri",
                  "minLength": 8,
                  "maxLength": 4096,
                  "description": "A public HTTPS URL."
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Optional seed URLs to read instead of searching."
              },
              "followLinks": {
                "type": "boolean",
                "default": false,
                "description": "Follow query-relevant links discovered on read pages across rounds (same host when seed urls are supplied)."
              },
              "maxSources": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20,
                "default": 5,
                "description": "Maximum distinct sources to keep in context."
              },
              "maxRounds": {
                "type": "integer",
                "minimum": 1,
                "maximum": 3,
                "description": "Maximum retrieval rounds (defaults to 2 when followLinks is true, otherwise 1)."
              },
              "maxPages": {
                "type": "integer",
                "minimum": 1,
                "maximum": 40,
                "description": "Maximum total pages to read across rounds."
              },
              "planQueries": {
                "type": "boolean",
                "description": "Ask the model to plan follow-up search queries across rounds (search discovery only)."
              },
              "answer": {
                "type": "boolean",
                "default": true,
                "description": "Synthesize a cited answer (or structured data when schema is supplied); false returns sources only."
              },
              "schema": {
                "type": "object",
                "additionalProperties": true,
                "description": "Optional JSON Schema for structured research output (requires answer: true)."
              },
              "render": {
                "type": "boolean",
                "default": true,
                "description": "Render pages in a browser before reading them."
              }
            },
            "required": [
              "query"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "list_open_roles",
          "title": "List a company's open roles",
          "description": "A company's open roles from its own Greenhouse, Lever, Ashby, Workable, Recruitee or Personio job board, read from the platform's public API: title, link, department and team, locations, workplace and employment type, dates, and published pay where the board shows it. url is the board, one of its job pages, or a careers page that links exactly one board. Returns the first 25 postings without their text unless asked; to read postings, ask for descriptions with a small maxJobs. truncated says whether more remain. Counts as page reads.",
          "needs": "careers",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "Such as https://jobs.lever.co/acme, https://job-boards.greenhouse.io/acme, or a company's careers page."
              },
              "maxJobs": {
                "type": "integer",
                "minimum": 1,
                "maximum": 1000,
                "default": 25
              },
              "descriptions": {
                "type": "boolean",
                "default": false,
                "description": "Include each posting's full text."
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "diff_pages",
          "title": "Compare pages or text snapshots",
          "description": "Run deterministic structural change detection and redlines across two URLs, two inline text snapshots, or a baseline text and a live URL, with materiality scoring and a SHA-256 attestation digest.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "beforeUrl": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "Public HTTPS URL of the earlier page version. Provide beforeUrl or beforeText."
              },
              "beforeText": {
                "type": "string",
                "minLength": 1,
                "maxLength": 30000,
                "description": "Inline baseline text or markdown snapshot instead of beforeUrl."
              },
              "afterUrl": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "Public HTTPS URL of the newer page version. Provide afterUrl or afterText."
              },
              "afterText": {
                "type": "string",
                "minLength": 1,
                "maxLength": 30000,
                "description": "Inline updated text or markdown snapshot instead of afterUrl."
              },
              "mode": {
                "type": "string",
                "enum": [
                  "prose",
                  "pricing",
                  "policy",
                  "risk_factors"
                ],
                "default": "prose",
                "description": "Materiality profile: prose, pricing, policy, or risk_factors."
              },
              "maxChanges": {
                "type": "integer",
                "minimum": 1,
                "maximum": 200,
                "default": 50,
                "description": "Maximum number of changes to return (1 to 200)."
              },
              "render": {
                "type": "boolean",
                "default": false,
                "description": "Render URL inputs in a browser before diffing."
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "parse_document",
          "title": "Parse a PDF or Office document",
          "description": "Parse a PDF, DOCX, XLSX, or PPTX file into structured pages, typed blocks (headings, paragraphs, lists, tables), clean markdown, and exact character citation offsets.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "Public HTTPS URL of the document. Provide url or documentBase64."
              },
              "documentBase64": {
                "type": "string",
                "minLength": 1,
                "maxLength": 30000,
                "description": "Base64-encoded document payload instead of url (prefer url for files near or above 20 KiB)."
              },
              "filename": {
                "type": "string",
                "minLength": 1,
                "maxLength": 256,
                "description": "Optional filename hint such as annual-report.pdf."
              },
              "kind": {
                "type": "string",
                "enum": [
                  "pdf",
                  "docx",
                  "xlsx",
                  "pptx"
                ],
                "description": "Document format hint: pdf, docx, xlsx, or pptx."
              },
              "format": {
                "type": "string",
                "enum": [
                  "structured",
                  "markdown",
                  "both"
                ],
                "default": "both",
                "description": "Output shape: structured, markdown, or both."
              },
              "maxPages": {
                "type": "integer",
                "minimum": 1,
                "maximum": 500,
                "default": 50,
                "description": "Maximum pages, sheets, or slides to parse (1 to 500)."
              },
              "maxCharacters": {
                "type": "integer",
                "minimum": 100,
                "maximum": 1000000,
                "default": 20000,
                "description": "Character budget for extracted text and markdown."
              },
              "render": {
                "type": "boolean",
                "default": false,
                "description": "Fetch URL targets through Chromium instead of direct HTTPS."
              },
              "ocr": {
                "type": "string",
                "enum": [
                  "off",
                  "auto",
                  "force"
                ],
                "default": "auto",
                "description": "Self-hosted OCR fallback for scanned PDFs: off, auto (default), or force."
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "verify_claim",
          "title": "Verify a factual claim",
          "description": "Deterministically verify a factual claim against supplied URLs or search discovery, returning a verdict, verbatim evidence passages with character offsets, content hashes, and a SHA-256 attestation digest.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "claim": {
                "type": "string",
                "minLength": 3,
                "maxLength": 2000,
                "description": "Claim statement to check against live pages."
              },
              "urls": {
                "type": "array",
                "items": {
                  "type": "string",
                  "format": "uri",
                  "minLength": 8,
                  "maxLength": 4096,
                  "description": "A public HTTPS URL."
                },
                "minItems": 1,
                "maxItems": 10,
                "description": "1 to 10 public HTTPS URLs to inspect instead of search discovery."
              },
              "query": {
                "type": "string",
                "minLength": 1,
                "maxLength": 500,
                "description": "Optional search discovery query (cannot accompany urls)."
              },
              "maxSources": {
                "type": "integer",
                "minimum": 1,
                "maximum": 10,
                "default": 3,
                "description": "Maximum distinct sources to inspect (1 to 10)."
              },
              "minOverlap": {
                "type": "number",
                "minimum": 0,
                "maximum": 1,
                "description": "Optional minimum lexical overlap score from 0 to 1."
              }
            },
            "required": [
              "claim"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "entity_dossier",
          "title": "Build a company dossier",
          "description": "Assemble a live company footprint and alt-data dossier across web profile, ATS open roles, Investor Relations releases, DNS/MX/SPF/DMARC SaaS infrastructure, SEC filings, and recent news.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "domain": {
                "type": "string",
                "minLength": 3,
                "maxLength": 255,
                "description": "Company public domain name (such as stripe.com) or HTTPS URL."
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "Optional legal or brand name for filings and news lookups."
              },
              "ticker": {
                "type": "string",
                "minLength": 1,
                "maxLength": 12,
                "pattern": "^[A-Za-z0-9.-]{1,12}$",
                "description": "Optional stock ticker (1 to 12 characters)."
              },
              "modules": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "profile",
                    "careers",
                    "ir",
                    "infra",
                    "filings",
                    "news"
                  ]
                },
                "minItems": 1,
                "maxItems": 6,
                "description": "Dossier modules to collect (defaults to profile, careers, ir, infra)."
              },
              "maxItems": {
                "type": "integer",
                "minimum": 1,
                "maximum": 50,
                "default": 10,
                "description": "Maximum items per list module (1 to 50)."
              }
            },
            "required": [
              "domain"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "enrich_grid",
          "title": "Enrich an entity matrix",
          "description": "Evaluate an entities-by-columns enrichment matrix synchronously using entity dossiers, index search, claim verification, or official data sources, with citations and isolated per-cell errors.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "entities": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200,
                      "description": "Entity display or company name."
                    },
                    "domain": {
                      "type": "string",
                      "minLength": 3,
                      "maxLength": 255,
                      "description": "Optional public domain or HTTPS URL."
                    },
                    "ticker": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 12,
                      "pattern": "^[A-Za-z0-9.-]{1,12}$",
                      "description": "Optional stock ticker."
                    }
                  },
                  "required": [
                    "name"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1,
                "maxItems": 10,
                "description": "1 to 10 entities to enrich."
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{1,64}$",
                      "description": "Unique column identifier."
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 120,
                      "description": "Optional human-readable column label."
                    },
                    "strategy": {
                      "type": "string",
                      "enum": [
                        "entity",
                        "search",
                        "verify",
                        "source"
                      ],
                      "description": "Evaluation strategy: entity, search, verify, or source."
                    },
                    "field": {
                      "type": "string",
                      "pattern": "^[a-zA-Z0-9_.]{1,120}$",
                      "description": "Dotted output path for entity or source strategy columns."
                    },
                    "query": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 500,
                      "description": "Query template supporting {{name}}, {{domain}}, {{ticker}} for search strategy."
                    },
                    "claim": {
                      "type": "string",
                      "minLength": 3,
                      "maxLength": 500,
                      "description": "Claim template for verify strategy."
                    },
                    "provider": {
                      "type": "string",
                      "pattern": "^[a-z][a-z0-9-]{1,40}$",
                      "description": "A provider id, such as openfda."
                    },
                    "capability": {
                      "type": "string",
                      "pattern": "^[a-z][a-z0-9-]*(?:/[a-z][a-z0-9-]*){0,2}$",
                      "description": "A capability id, such as recalls/search."
                    },
                    "options": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Options object for source strategy columns."
                    }
                  },
                  "required": [
                    "id",
                    "strategy"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1,
                "maxItems": 10,
                "description": "1 to 10 column definitions."
              },
              "concurrency": {
                "type": "integer",
                "minimum": 1,
                "maximum": 4,
                "default": 2,
                "description": "Parallel cell workers (1 to 4)."
              }
            },
            "required": [
              "entities",
              "columns"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "investor_relations",
          "title": "Read an Investor Relations portal",
          "description": "Discover presentations, press releases, financial reports, transcripts, and webcasts from a company's Investor Relations site via Q4 JSON feeds or rendered HTML section traversal.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "Company IR portal URL or main website URL."
              },
              "kinds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "presentation",
                    "press_release",
                    "financial_report",
                    "transcript",
                    "webcast",
                    "other"
                  ]
                },
                "minItems": 1,
                "maxItems": 6,
                "description": "Filter items by kind: presentation, press_release, financial_report, transcript, webcast, other."
              },
              "maxItems": {
                "type": "integer",
                "minimum": 1,
                "maximum": 200,
                "default": 25,
                "description": "Maximum IR items to return (1 to 200)."
              },
              "followSections": {
                "type": "boolean",
                "default": true,
                "description": "Follow discovered IR section links when structured Q4 feeds are unavailable."
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "list_firehose_events",
          "title": "Read structured public-registry events",
          "description": "Read normalized public-registry and SEC EDGAR filing events across CISA KEV, Federal Register, FDA recalls, U.S. Treasury debt, 8-K, SC 13D, and Form 4, filtered by topic and date.",
          "needs": "sources",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "topics": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "cisa-kev",
                    "federal-register",
                    "fda-drug-recalls",
                    "fda-device-recalls",
                    "treasury-debt",
                    "sec-8k",
                    "sec-13d",
                    "sec-form4"
                  ]
                },
                "minItems": 1,
                "maxItems": 8,
                "description": "Event topics to include (defaults to all eight topics)."
              },
              "since": {
                "type": "string",
                "format": "date",
                "description": "Include events on or after YYYY-MM-DD."
              },
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100,
                "default": 20,
                "description": "Maximum events to return (1 to 100)."
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "capture_screenshot",
          "title": "Capture a browser screenshot",
          "description": "Render a public HTTPS page in Chromium and capture a PNG or JPEG screenshot returned as base64 artifact data.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "A public HTTPS URL."
              },
              "format": {
                "type": "string",
                "enum": [
                  "png",
                  "jpeg"
                ],
                "default": "png"
              },
              "fullPage": {
                "type": "boolean",
                "default": true
              },
              "width": {
                "type": "integer",
                "minimum": 320,
                "maximum": 4096,
                "default": 1440
              },
              "height": {
                "type": "integer",
                "minimum": 240,
                "maximum": 4096,
                "default": 960
              },
              "waitFor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "Wait for this CSS selector before capturing."
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "capture_pdf",
          "title": "Render a page to PDF",
          "description": "Render a public HTTPS page in Chromium and print it to PDF with optional page ranges, scale factor, and background graphics control.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "A public HTTPS URL."
              },
              "width": {
                "type": "integer",
                "minimum": 320,
                "maximum": 4096,
                "default": 1440
              },
              "height": {
                "type": "integer",
                "minimum": 240,
                "maximum": 4096,
                "default": 960
              },
              "pageRanges": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "description": "1-based page numbers or ranges, such as 1-3 or 1-2,5."
              },
              "scale": {
                "type": "number",
                "minimum": 0.1,
                "maximum": 2,
                "description": "Page scale factor from 0.1 to 2."
              },
              "printBackground": {
                "type": "boolean",
                "default": true
              },
              "waitFor": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "Wait for this CSS selector before printing."
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "list_linked_documents",
          "title": "Find or download linked documents",
          "description": "Discover PDF, DOCX, XLSX, and PPTX links on a rendered page; lists metadata by default (download: false) or downloads files as base64 with SHA-256 hashes when download: true.",
          "needs": "read",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "minLength": 8,
                "maxLength": 4096,
                "description": "A public HTTPS URL."
              },
              "kinds": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "pdf",
                    "docx",
                    "xlsx",
                    "pptx"
                  ]
                },
                "minItems": 1,
                "maxItems": 4,
                "description": "Document kinds to collect (defaults to pdf)."
              },
              "maxFiles": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20,
                "default": 10,
                "description": "Maximum documents to process (1 to 20)."
              },
              "download": {
                "type": "boolean",
                "default": false,
                "description": "false lists discovered links without file bytes; true downloads each document through Chromium."
              }
            },
            "required": [
              "url"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "search_index",
          "title": "Search Vitna's web index",
          "description": "Ranked pages from Vitna's own web index, with effort presets (fast, balanced, deep), point-in-time asOf historical snapshots, inline contents/excerpts, and optional live scraping of each hit.",
          "needs": "search",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000
              },
              "maxResults": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20,
                "default": 5
              },
              "domains": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 253
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Restrict results to these public domains."
              },
              "excludeDomains": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 253
                },
                "minItems": 1,
                "maxItems": 20,
                "description": "Exclude these public domains."
              },
              "maxAgeDays": {
                "type": "integer",
                "minimum": 1,
                "maximum": 3650,
                "description": "Filter by observed crawl age in days."
              },
              "asOf": {
                "type": "string",
                "minLength": 10,
                "maxLength": 64,
                "description": "Point-in-time snapshot cutoff (YYYY-MM-DD or ISO 8601 with UTC offset); enforces zero lookahead and cannot accompany scrape."
              },
              "ranking": {
                "type": "string",
                "enum": [
                  "lexical",
                  "semantic"
                ],
                "description": "Ranking mode (lexical by default)."
              },
              "effort": {
                "type": "string",
                "enum": [
                  "fast",
                  "balanced",
                  "deep"
                ],
                "description": "Effort preset: fast, balanced, or deep."
              },
              "contents": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": [
                      "boolean",
                      "object"
                    ],
                    "properties": {
                      "maxCharacters": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 100000
                      },
                      "maxTokens": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 25000
                      }
                    },
                    "additionalProperties": false,
                    "description": "Include stored page text: true for 20,000 characters, or an object with maxCharacters or maxTokens."
                  },
                  "highlights": {
                    "type": [
                      "boolean",
                      "object"
                    ],
                    "properties": {
                      "maxCharacters": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 4000
                      },
                      "maxTokens": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000
                      },
                      "query": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1000
                      }
                    },
                    "additionalProperties": false,
                    "description": "Include verbatim sentence highlights matching the query."
                  },
                  "excerpts": {
                    "type": [
                      "boolean",
                      "object"
                    ],
                    "properties": {
                      "maxCharacters": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 4000
                      },
                      "maxTokens": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000
                      },
                      "query": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1000
                      }
                    },
                    "additionalProperties": false,
                    "description": "Include contiguous BM25/embedding sentence windows for single-call grounding."
                  },
                  "maxTotalCharacters": {
                    "type": "integer",
                    "minimum": 100,
                    "maximum": 400000,
                    "description": "Cap total characters across all results."
                  },
                  "maxTotalTokens": {
                    "type": "integer",
                    "minimum": 25,
                    "maximum": 100000,
                    "description": "Cap total estimated tokens (4 chars/token) across all results."
                  },
                  "injection": {
                    "type": "string",
                    "enum": [
                      "scan",
                      "strip"
                    ],
                    "description": "scan reports prompt-injection patterns; strip also removes invisible characters from content."
                  },
                  "snapshotAsOf": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 64,
                    "description": "Point-in-time snapshot cutoff (YYYY-MM-DD or ISO 8601 with UTC offset) for historical extraction."
                  }
                },
                "required": [],
                "additionalProperties": false,
                "description": "Inline stored page text, highlights, or excerpts read without a live fetch."
              },
              "scrape": {
                "type": [
                  "boolean",
                  "object"
                ],
                "properties": {
                  "format": {
                    "type": "string",
                    "enum": [
                      "markdown",
                      "text"
                    ]
                  },
                  "maxCharacters": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100000
                  },
                  "render": {
                    "type": "boolean"
                  },
                  "onlyMainContent": {
                    "type": "boolean",
                    "description": "Extract only the main content (true by default); false keeps header, nav, aside, and footer chrome."
                  },
                  "includeTags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "minItems": 1,
                    "maxItems": 20,
                    "description": "Keep only elements matching these CSS selectors (1 to 20)."
                  },
                  "excludeTags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "minItems": 1,
                    "maxItems": 20,
                    "description": "Omit elements matching these CSS selectors (1 to 20)."
                  },
                  "extract": {
                    "type": "object",
                    "properties": {
                      "selectors": {
                        "type": "object",
                        "additionalProperties": true,
                        "description": "Field names mapped to CSS selectors or { selector, attribute }."
                      },
                      "schema": {
                        "type": "object",
                        "additionalProperties": true,
                        "description": "A JSON Schema object for extracted data."
                      },
                      "prompt": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 10000,
                        "description": "Plain-language extraction instruction (needs a configured language model)."
                      }
                    },
                    "required": [],
                    "additionalProperties": false,
                    "description": "Extract structured fields from the rendered page."
                  },
                  "highlights": {
                    "type": [
                      "boolean",
                      "object"
                    ],
                    "properties": {
                      "query": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1000,
                        "description": "Select verbatim passages relevant to this query."
                      },
                      "maxCharacters": {
                        "type": "integer",
                        "minimum": 100,
                        "maximum": 4000,
                        "description": "Character budget for highlights (1,000 unless given)."
                      }
                    },
                    "additionalProperties": false,
                    "description": "Return ranked verbatim passages from the page: true for up to 1,000 characters, or an object with query and maxCharacters."
                  },
                  "question": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "Answer one question grounded in the rendered page."
                  },
                  "injection": {
                    "type": "string",
                    "enum": [
                      "scan",
                      "strip"
                    ],
                    "description": "scan reports prompt-injection patterns; strip also removes invisible characters from content."
                  },
                  "redact": {
                    "type": [
                      "boolean",
                      "array"
                    ],
                    "items": {
                      "type": "string",
                      "enum": [
                        "email",
                        "phone",
                        "card",
                        "iban",
                        "ssn",
                        "ip"
                      ]
                    },
                    "minItems": 1,
                    "maxItems": 6,
                    "description": "true redacts all supported personal-data kinds; a list redacts only those kinds."
                  }
                },
                "additionalProperties": false,
                "description": "Also scrape each hit live in one call: true for defaults, or an object with format, maxCharacters, render, onlyMainContent, includeTags, excludeTags, highlights, question, extract, injection, or redact."
              }
            },
            "required": [
              "query"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "discover_grid",
          "title": "Discover and verify structured entity grids",
          "description": "Discover and verify up to 10 entities against explicit criteria with verbatim quotes and SHA-256 attestations under hard search/verification budgets, and optionally enrich each row with entity, search, verify, or source columns. Synchronous within the request deadline.",
          "needs": "search",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "entities": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "domain": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 255
                    },
                    "ticker": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 12
                    }
                  },
                  "required": [
                    "name"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1,
                "maxItems": 10,
                "description": "Optional explicit seed entities (1 to 10)."
              },
              "discover": {
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500,
                    "description": "Discovery search query."
                  },
                  "entityType": {
                    "type": "string",
                    "enum": [
                      "company",
                      "person",
                      "paper",
                      "product",
                      "organization",
                      "any"
                    ],
                    "default": "any"
                  },
                  "count": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10,
                    "default": 10,
                    "description": "Target number of verified entities (1 to 10 synchronously)."
                  },
                  "criteria": {
                    "type": "array",
                    "items": {
                      "type": [
                        "string",
                        "object"
                      ],
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9_-]{1,64}$"
                        },
                        "description": {
                          "type": "string",
                          "minLength": 3,
                          "maxLength": 300
                        },
                        "required": {
                          "type": "boolean",
                          "default": true
                        }
                      },
                      "additionalProperties": false,
                      "description": "Verification criterion string or { id, description, required }."
                    },
                    "minItems": 1,
                    "maxItems": 8
                  },
                  "domains": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 253
                    },
                    "minItems": 1,
                    "maxItems": 20,
                    "description": "Restrict candidate discovery to these domains."
                  },
                  "excludeDomains": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 253
                    },
                    "minItems": 1,
                    "maxItems": 20,
                    "description": "Exclude these domains from candidate discovery."
                  },
                  "queries": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 500
                    },
                    "minItems": 1,
                    "maxItems": 5
                  },
                  "index": {
                    "type": "string",
                    "enum": [
                      "web",
                      "research",
                      "developer",
                      "government",
                      "filings",
                      "security",
                      "clinical",
                      "patents",
                      "knowledge",
                      "finance",
                      "public-records",
                      "health",
                      "ai",
                      "media",
                      "gaming",
                      "sports",
                      "listings",
                      "ecommerce",
                      "social",
                      "real-estate",
                      "jobs",
                      "legal",
                      "travel",
                      "energy-climate"
                    ]
                  },
                  "asOf": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 64
                  }
                },
                "required": [
                  "query"
                ],
                "additionalProperties": false
              },
              "budget": {
                "type": "object",
                "properties": {
                  "maxSearches": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 40
                  },
                  "maxVerifications": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 200
                  },
                  "maxDurationMs": {
                    "type": "integer",
                    "minimum": 1000,
                    "maximum": 300000
                  }
                },
                "required": [],
                "additionalProperties": false,
                "description": "Hard execution budgets across discovery and verification."
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{1,64}$"
                    },
                    "label": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 120
                    },
                    "strategy": {
                      "type": "string",
                      "enum": [
                        "entity",
                        "search",
                        "verify",
                        "source"
                      ]
                    },
                    "field": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 120
                    },
                    "query": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 500
                    },
                    "claim": {
                      "type": "string",
                      "minLength": 3,
                      "maxLength": 500
                    },
                    "provider": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    },
                    "capability": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    },
                    "options": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  },
                  "required": [
                    "id",
                    "strategy"
                  ],
                  "additionalProperties": false
                },
                "minItems": 0,
                "maxItems": 10,
                "description": "Optional enrichment columns."
              },
              "concurrency": {
                "type": "integer",
                "minimum": 1,
                "maximum": 4
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "google_search",
          "title": "Search Google",
          "description": "Google's results page for a query, captured and parsed by Vitna: organic results with title, link, snippet, displayed link and sitelinks, and with extras, rich page features (answer box, knowledge graph, AI Overview, top stories, local results, People Also Ask, related searches and ads). The fields are SerpApi's (search_metadata, organic_results, related_questions, pagination) unless shape asks for Vitna's own. When Google does not answer in time, Bing may: meta.engine then says bing, and search_metadata gives bing_url instead of google_url. A search can take up to a minute. It runs on Vitna's search service with the org's Vitna key (vitna_key_...) and counts as one of its searches.",
          "needs": "serp",
          "annotations": {
            "readOnlyHint": true,
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true
          },
          "inputSchema": {
            "type": "object",
            "properties": {
              "q": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000,
                "description": "The query, as typed into Google; operators such as site: work."
              },
              "gl": {
                "type": "string",
                "pattern": "^[A-Za-z]{2}$",
                "description": "The country to search from, as a two-letter code such as us or de."
              },
              "hl": {
                "type": "string",
                "maxLength": 32,
                "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8}){0,2}$",
                "description": "The interface language, such as en or pt-BR."
              },
              "google_domain": {
                "type": "string",
                "enum": [
                  "google.com",
                  "google.co.uk",
                  "google.ca",
                  "google.com.au",
                  "google.de",
                  "google.fr",
                  "google.es",
                  "google.it",
                  "google.nl",
                  "google.be",
                  "google.ch",
                  "google.at",
                  "google.se",
                  "google.no",
                  "google.dk",
                  "google.pl",
                  "google.co.jp",
                  "google.co.kr",
                  "google.co.in",
                  "google.com.br",
                  "google.com.mx",
                  "google.com.sg",
                  "google.com.hk",
                  "google.com.tw",
                  "google.ie"
                ],
                "description": "Regional Google domain, such as google.com, google.co.uk or google.de."
              },
              "location": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128,
                "description": "Canonical location name encoded to Google UULE, such as New York,New York,United States."
              },
              "uule": {
                "type": "string",
                "pattern": "^(?:w\\+CAIQICI[A-Za-z0-9_-]{1,256}|a\\+[A-Za-z0-9+/=_-]{1,256})$",
                "description": "Encoded Google UULE location token; give location or uule, not both."
              },
              "tbs": {
                "type": "string",
                "pattern": "^[A-Za-z0-9:_,./-]{1,128}$",
                "description": "Google search filter, such as qdr:d, qdr:w, qdr:m or qdr:y."
              },
              "tbm": {
                "type": "string",
                "enum": [
                  "nws",
                  "isch",
                  "vid",
                  "shop"
                ],
                "description": "Google vertical tab: news (nws), images (isch), videos (vid) or shopping (shop)."
              },
              "lr": {
                "type": "string",
                "pattern": "^lang_[a-z]{2}(?:-[A-Z]{2})?(?:\\|lang_[a-z]{2}(?:-[A-Z]{2})?){0,4}$",
                "description": "Google language restriction, such as lang_en."
              },
              "cr": {
                "type": "string",
                "pattern": "^country[A-Z]{2}(?:\\|country[A-Z]{2}){0,4}$",
                "description": "Google country restriction, such as countryUS."
              },
              "safe": {
                "type": "string",
                "enum": [
                  "active",
                  "off"
                ],
                "description": "SafeSearch setting."
              },
              "nfpr": {
                "type": "boolean",
                "description": "When true, disables Google query auto-correction."
              },
              "udm": {
                "type": "string",
                "enum": [
                  "2",
                  "7",
                  "12",
                  "14",
                  "28"
                ],
                "description": "Google display mode, such as 14 for web-only results."
              },
              "filter": {
                "type": "string",
                "enum": [
                  "0"
                ],
                "description": "0 to include entries Google otherwise omits as very similar."
              },
              "include_omitted": {
                "type": "boolean",
                "description": "When Google omits very similar entries, re-run automatically with filter=0."
              },
              "start": {
                "type": "integer",
                "minimum": 0,
                "maximum": 190,
                "default": 0,
                "description": "Results to skip: 0 for the first page, 10 for the second."
              },
              "num": {
                "type": "integer",
                "minimum": 1,
                "maximum": 30,
                "default": 10,
                "description": "Organic results to return, from 1 to 30."
              },
              "device": {
                "type": "string",
                "default": "desktop",
                "description": "desktop only: Vitna captures Google's desktop results page and has no mobile or tablet capture."
              },
              "extras": {
                "type": "boolean",
                "default": false,
                "description": "Also return rich SERP features, People Also Ask, related searches and ads."
              },
              "no_cache": {
                "type": "boolean",
                "default": false,
                "description": "Capture a new page rather than reuse this key's answer to the same search from the last few minutes."
              },
              "shape": {
                "type": "string",
                "enum": [
                  "serpapi",
                  "vitna"
                ],
                "default": "serpapi",
                "description": "serpapi for SerpApi's field names; vitna for Vitna's own (general, organic, meta), as POST /v1/serp answers by default."
              }
            },
            "required": [
              "q"
            ],
            "additionalProperties": false
          }
        }
      ]
    }
  ]
}
