Pipeworx Hcup Inpatient Stats MCP

{
  "type": "object",
  "examples": [
    {
      "question": "What was Apple's revenue in 2024?"
    },
    {
      "question": "Any recent SEC filings for $NVDA?"
    },
    {
      "question": "Current price of bitcoin"
    }
  ],
  "required": [
    "question"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Alias for question."
    },
    "ask": {
      "type": "string",
      "description": "Alias for question."
    },
    "text": {
      "type": "string",
      "description": "Alias for question."
    },
    "input": {
      "type": "string",
      "description": "Alias for question."
    },
    "packs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "OPTIONAL. Restrict routing to these pack slugs (e.g. [\"sec-form-d\",\"sec-13f\"]) — the router then picks only from tools in those packs. Omit for the default full-catalog routing. Slugs come from list_packs / search_packs / https://pipeworx.io/directory; unlisted or unknown slugs are ignored and named in _meta.pack_scope.ignored, and if none of them resolves the question is routed across the whole catalog with _meta.pack_scope.full_catalog:true (never an empty answer)."
    },
    "query": {
      "type": "string",
      "description": "Alias for question."
    },
    "prompt": {
      "type": "string",
      "description": "Alias for question."
    },
    "message": {
      "type": "string",
      "description": "Alias for question."
    },
    "question": {
      "type": "string",
      "description": "Your question or request in natural language. Accepts query, q, prompt, text, input, ask, message as aliases."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "question": "What is the current US unemployment rate?"
    }
  ],
  "required": [
    "question"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Alias for question."
    },
    "ask": {
      "type": "string",
      "description": "Alias for question."
    },
    "text": {
      "type": "string",
      "description": "Alias for question."
    },
    "input": {
      "type": "string",
      "description": "Alias for question."
    },
    "packs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "OPTIONAL. Restrict routing to these pack slugs (e.g. [\"sec-form-d\",\"sec-13f\"]) — the router then picks only from tools in those packs. Omit for the default full-catalog routing. Slugs come from list_packs / search_packs / https://pipeworx.io/directory; unlisted or unknown slugs are ignored and named in _meta.pack_scope.ignored, and if none of them resolves the question is routed across the whole catalog with _meta.pack_scope.full_catalog:true (never an empty answer)."
    },
    "query": {
      "type": "string",
      "description": "Alias for question."
    },
    "prompt": {
      "type": "string",
      "description": "Alias for question."
    },
    "message": {
      "type": "string",
      "description": "Alias for question."
    },
    "question": {
      "type": "string",
      "description": "Your question or request in natural language. Accepts query, q, prompt, text, input, ask, message as aliases."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "question": "What was Apple's fiscal 2023 revenue?"
    }
  ],
  "required": [
    "question"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Alias for question."
    },
    "ask": {
      "type": "string",
      "description": "Alias for question."
    },
    "text": {
      "type": "string",
      "description": "Alias for question."
    },
    "input": {
      "type": "string",
      "description": "Alias for question."
    },
    "query": {
      "type": "string",
      "description": "Alias for question."
    },
    "prompt": {
      "type": "string",
      "description": "Alias for question."
    },
    "message": {
      "type": "string",
      "description": "Alias for question."
    },
    "question": {
      "type": "string",
      "description": "Your question in natural language. Accepts query, q, prompt, text, input, ask, message as aliases."
    },
    "prefer_tool": {
      "type": "string",
      "description": "Run this exact tool instead of letting the router choose — use a name from a previous answer's alternatives[]. Arguments are still filled from your question. Unknown names are refused, never guessed."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "text": "Apple Inc. reported fiscal 2023 revenue of $383.285 billion, driven by strong iPhone and Services growth. Net income was $96.995 billion. The company faced supply-chain risk in China during the quarter.",
      "query": "supply-chain risk"
    }
  ],
  "required": [
    "text",
    "query"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "The document text to search inside (max ~200K chars)."
    },
    "limit": {
      "type": "number",
      "description": "Max passages to return (1-20, default 5)."
    },
    "query": {
      "type": "string",
      "description": "Natural-language query — what passages do you want? E.g. \"supply-chain risk\", \"fiscal year 2024 revenue\", \"drug interactions with warfarin\"."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "depth": "quick",
      "question": "What is the current US unemployment rate and how has it changed over the past year?"
    }
  ],
  "required": [
    "question"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Alias for question."
    },
    "ask": {
      "type": "string",
      "description": "Alias for question."
    },
    "text": {
      "type": "string",
      "description": "Alias for question."
    },
    "depth": {
      "enum": [
        "quick",
        "standard",
        "thorough"
      ],
      "type": "string",
      "description": "How many facets to research in parallel: quick=3 (single hop), standard=3 (default; adds a gap-recovery hop that re-angles unanswered facets + a contradictions[] scan across findings), thorough=6 (paid; adds a full iterative hop that chases leads + recovers gaps, plus the contradictions[] scan)."
    },
    "input": {
      "type": "string",
      "description": "Alias for question."
    },
    "query": {
      "type": "string",
      "description": "Alias for question."
    },
    "prompt": {
      "type": "string",
      "description": "Alias for question."
    },
    "message": {
      "type": "string",
      "description": "Alias for question."
    },
    "question": {
      "type": "string",
      "description": "The research question, in natural language. Broad/multi-part is fine — decomposition is the point. Accepts query, q, prompt, text, input, ask, message as aliases."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "query": "look up FDA drug approvals"
    },
    {
      "query": "analyze housing market trends"
    }
  ],
  "required": [
    "query"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Alias for query."
    },
    "task": {
      "type": "string",
      "description": "Alias for query."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of tools to return (default 20, max 50)"
    },
    "query": {
      "type": "string",
      "description": "Natural language description of what you want to do (e.g., \"analyze housing market trends\", \"look up FDA drug approvals\", \"find trade data between countries\"). Accepts task, q, description, search as aliases."
    },
    "search": {
      "type": "string",
      "description": "Alias for query."
    },
    "description": {
      "type": "string",
      "description": "Alias for query."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "type": "company",
      "value": "AAPL"
    }
  ],
  "required": [
    "type",
    "value"
  ],
  "properties": {
    "type": {
      "enum": [
        "company",
        "drug"
      ],
      "type": "string",
      "description": "Entity type: \"company\" or \"drug\"."
    },
    "value": {
      "type": "string",
      "description": "For company: ticker (AAPL), CIK (0000320193), or name. For drug: brand or generic name (e.g., \"ozempic\", \"metformin\"). Pass the ENTITY NAME ONLY — for a bond that is the ISSUER exactly as printed (\"NEW YORK ST DORM AUTH\"), never the question's full noun phrase (\"NEW YORK ST DORM AUTH revenue bonds\"): the FIGI lookup matches instrument names, so trailing security-class words match nothing."
    },
    "country": {
      "type": "string",
      "description": "OPTIONAL ISO 3166-1 alpha-2 of the country whose business register you mean (\"NO\", \"FI\", \"JP\", \"GB\", \"FR\", \"EE\", \"BR\"). Narrows the national-register fan-out and is often the difference between the right company and a US namesake — \"Apple\" with country \"NO\" is a Norwegian company, not Apple Inc. Omitting it searches every register we can name, which is the right default when you do not know. company only; ignored for drug."
    }
  }
}

{
  "type": "object",
  "required": [
    "type",
    "query",
    "resolved",
    "ids",
    "sources",
    "unresolved"
  ],
  "properties": {
    "ids": {
      "type": "object",
      "description": "Every identifier established: cik, ticker, company_name, lei, figi, isin, cusip, register_id, register_country. A key absent here appears in `unresolved` with a reason — never silently dropped."
    },
    "type": {
      "type": "string"
    },
    "brand": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "related": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "country",
          "register",
          "register_key",
          "register_id",
          "legal_name",
          "score",
          "status"
        ],
        "properties": {
          "lei": {
            "type": [
              "string",
              "null"
            ],
            "description": "From the GLEIF crosswalk when present. Never guessed from a name."
          },
          "score": {
            "type": "number",
            "description": "0-1, assigned centrally. An adapter never grades itself."
          },
          "status": {
            "enum": [
              "active",
              "inactive",
              "dissolved",
              "unknown"
            ],
            "type": "string",
            "description": "The COMPANY's status."
          },
          "country": {
            "type": "string",
            "description": "ISO-2 of the REGISTER, not of the company's operations."
          },
          "register": {
            "type": "string",
            "description": "Publisher + dataset, e.g. \"Brønnøysund Register Centre, Enhetsregisteret\". Never a URL or filename."
          },
          "data_as_of": {
            "type": [
              "string",
              "null"
            ],
            "description": "That register's own snapshot date, per row, so a stale country is visible."
          },
          "legal_form": {
            "type": [
              "string",
              "null"
            ]
          },
          "legal_name": {
            "type": "string"
          },
          "match_type": {
            "enum": [
              "id",
              "exact",
              "exact_form",
              "prefix",
              "tokens"
            ],
            "type": "string"
          },
          "status_raw": {
            "type": [
              "string",
              "null"
            ],
            "description": "The register's own status word, verbatim and unglossed."
          },
          "detail_tool": {
            "type": [
              "string",
              "null"
            ],
            "description": "The live pack tool that returns the full record, e.g. \"brreg-no:get_entity\"."
          },
          "register_id": {
            "type": "string",
            "description": "The native id in the register's own canonical formatting."
          },
          "matched_kind": {
            "enum": [
              "legal",
              "trading",
              "former",
              "english",
              "kana"
            ],
            "type": "string"
          },
          "matched_name": {
            "type": "string",
            "description": "The name row that matched, exactly as the publisher spells it."
          },
          "register_key": {
            "type": "string",
            "description": "Stable machine slug for the register."
          },
          "registration_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "GLEIF rows only: the LEI RECORD's lifecycle (ISSUED/LAPSED/RETIRED/...). A DIFFERENT fact from `status` — a lapsed LEI is unmaintained reference data about a company that may well still trade."
          }
        }
      },
      "description": "Entities that collapsed INTO the match, each carrying `collapsed_by`."
    },
    "sources": {
      "type": "object",
      "description": "Per-identifier provenance. Every key in `ids` has a matching key here."
    },
    "resolved": {
      "type": "boolean",
      "description": "At least one identifier was established. Read `match_status` and `unresolved` for WHICH — a company can be resolved in a national register with no CIK at all."
    },
    "searched": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "register",
          "register_key",
          "country",
          "rows"
        ],
        "properties": {
          "rows": {
            "type": "number"
          },
          "error": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "register": {
            "type": "string"
          },
          "data_as_of": {
            "type": [
              "string",
              "null"
            ]
          },
          "register_key": {
            "type": "string"
          }
        }
      },
      "description": "EVERY register asked, with its own as-of date and row count. A register that could not be reached carries `error` — 0 rows with an error is \"we could not ask\", 0 rows without one is \"nothing is there\", and they are different answers."
    },
    "registers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "country",
          "register",
          "register_key",
          "register_id",
          "legal_name",
          "score",
          "status"
        ],
        "properties": {
          "lei": {
            "type": [
              "string",
              "null"
            ],
            "description": "From the GLEIF crosswalk when present. Never guessed from a name."
          },
          "score": {
            "type": "number",
            "description": "0-1, assigned centrally. An adapter never grades itself."
          },
          "status": {
            "enum": [
              "active",
              "inactive",
              "dissolved",
              "unknown"
            ],
            "type": "string",
            "description": "The COMPANY's status."
          },
          "country": {
            "type": "string",
            "description": "ISO-2 of the REGISTER, not of the company's operations."
          },
          "register": {
            "type": "string",
            "description": "Publisher + dataset, e.g. \"Brønnøysund Register Centre, Enhetsregisteret\". Never a URL or filename."
          },
          "data_as_of": {
            "type": [
              "string",
              "null"
            ],
            "description": "That register's own snapshot date, per row, so a stale country is visible."
          },
          "legal_form": {
            "type": [
              "string",
              "null"
            ]
          },
          "legal_name": {
            "type": "string"
          },
          "match_type": {
            "enum": [
              "id",
              "exact",
              "exact_form",
              "prefix",
              "tokens"
            ],
            "type": "string"
          },
          "status_raw": {
            "type": [
              "string",
              "null"
            ],
            "description": "The register's own status word, verbatim and unglossed."
          },
          "detail_tool": {
            "type": [
              "string",
              "null"
            ],
            "description": "The live pack tool that returns the full record, e.g. \"brreg-no:get_entity\"."
          },
          "register_id": {
            "type": "string",
            "description": "The native id in the register's own canonical formatting."
          },
          "matched_kind": {
            "enum": [
              "legal",
              "trading",
              "former",
              "english",
              "kana"
            ],
            "type": "string"
          },
          "matched_name": {
            "type": "string",
            "description": "The name row that matched, exactly as the publisher spells it."
          },
          "register_key": {
            "type": "string",
            "description": "Stable machine slug for the register."
          },
          "registration_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "GLEIF rows only: the LEI RECORD's lifecycle (ISSUED/LAPSED/RETIRED/...). A DIFFERENT fact from `status` — a lapsed LEI is unmaintained reference data about a company that may well still trade."
          }
        }
      },
      "description": "The matched entity as every register that carries it — the match (flagged `matched: true`) plus anything that collapsed into it. A Companies House number AND the LEI that crosswalks to it are the SAME answer, not rivals."
    },
    "resources": {
      "type": "object"
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "country",
          "register",
          "register_key",
          "register_id",
          "legal_name",
          "score",
          "status"
        ],
        "properties": {
          "lei": {
            "type": [
              "string",
              "null"
            ],
            "description": "From the GLEIF crosswalk when present. Never guessed from a name."
          },
          "score": {
            "type": "number",
            "description": "0-1, assigned centrally. An adapter never grades itself."
          },
          "status": {
            "enum": [
              "active",
              "inactive",
              "dissolved",
              "unknown"
            ],
            "type": "string",
            "description": "The COMPANY's status."
          },
          "country": {
            "type": "string",
            "description": "ISO-2 of the REGISTER, not of the company's operations."
          },
          "register": {
            "type": "string",
            "description": "Publisher + dataset, e.g. \"Brønnøysund Register Centre, Enhetsregisteret\". Never a URL or filename."
          },
          "data_as_of": {
            "type": [
              "string",
              "null"
            ],
            "description": "That register's own snapshot date, per row, so a stale country is visible."
          },
          "legal_form": {
            "type": [
              "string",
              "null"
            ]
          },
          "legal_name": {
            "type": "string"
          },
          "match_type": {
            "enum": [
              "id",
              "exact",
              "exact_form",
              "prefix",
              "tokens"
            ],
            "type": "string"
          },
          "status_raw": {
            "type": [
              "string",
              "null"
            ],
            "description": "The register's own status word, verbatim and unglossed."
          },
          "detail_tool": {
            "type": [
              "string",
              "null"
            ],
            "description": "The live pack tool that returns the full record, e.g. \"brreg-no:get_entity\"."
          },
          "register_id": {
            "type": "string",
            "description": "The native id in the register's own canonical formatting."
          },
          "matched_kind": {
            "enum": [
              "legal",
              "trading",
              "former",
              "english",
              "kana"
            ],
            "type": "string"
          },
          "matched_name": {
            "type": "string",
            "description": "The name row that matched, exactly as the publisher spells it."
          },
          "register_key": {
            "type": "string",
            "description": "Stable machine slug for the register."
          },
          "registration_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "GLEIF rows only: the LEI RECORD's lifecycle (ISSUED/LAPSED/RETIRED/...). A DIFFERENT fact from `status` — a lapsed LEI is unmaintained reference data about a company that may well still trade."
          }
        }
      },
      "description": "Rivals, best first. Populated on \"ambiguous\" and on \"matched\" alike."
    },
    "ingredient": {
      "type": "string"
    },
    "unresolved": {
      "type": "object",
      "description": "Per-identifier reason an id could NOT be established — the honest twin of `ids`."
    },
    "cik_withheld": {
      "type": "string",
      "description": "A CIK that came back from a FUZZY SEC name match and is NOT asserted, because the spine matched a stronger non-US candidate, or `match_status` is \"ambiguous\" or \"incomplete\" and the SEC hit was not an exact ticker, CIK or legal name (fleet #3606). The number is here so a caller who wanted the US filer can still use it; what changed is that we no longer claim it IS the answer. See `unresolved.cik` for the reason."
    },
    "lei_withheld": {
      "type": "string",
      "description": "A LEI that is NOT asserted: it matched the bare string exactly in GLEIF, but `match_status` is \"ambiguous\" or \"incomplete\" so the registers cannot say which company that string means, and a GLEIF hit on the same string is the same guess from another register. `relationships` is withheld with it. A LEI from an exact SEC hit, or from a complete legal name carrying its legal form, is never withheld. See `unresolved.lei`."
    },
    "match_status": {
      "enum": [
        "matched",
        "ambiguous",
        "no_match",
        "incomplete"
      ],
      "type": "string",
      "description": "The headline to branch on. \"ambiguous\" is an ANSWER, not a failure: two companies matched the name equally well and both are in `candidates`. \"no_match\" means every register in `searched` was asked and none carried it. \"incomplete\" means one of them could NOT be asked (it carries an `error` in `searched[]`), so the candidate set is short by an unknown amount and no id is asserted — distinct from \"ambiguous\" because a RETRY is what resolves it, not a narrower query; `fanout_incomplete` names the unreachable registers and carries, under `withheld_match`, the candidate that would have been returned on a complete fan-out."
    },
    "figi_withheld": {
      "type": "string",
      "description": "A FIGI that is NOT asserted. Either it matched this name in OpenFIGI (`figi_match: \"name_search\"`) while `match_status` is \"incomplete\" — a name search cannot tell a company apart from a security carrying its name, and the registers that would have settled it are the ones we could not ask — or it is a `ticker_map` FIGI whose ticker came from a FUZZY SEC name match that is itself withheld (`cik_withheld`), so the mapping inherits the doubt. A `ticker_map` FIGI from an EXACT SEC hit (a real ticker, a CIK, an exact legal name) is never withheld. Carried so a caller who accepts the caveat can use it; see `unresolved.figi`."
    },
    "match_scoring": {
      "type": "object",
      "properties": {
        "top": {
          "type": [
            "number",
            "null"
          ]
        },
        "margin": {
          "type": [
            "number",
            "null"
          ]
        },
        "runner_up": {
          "type": [
            "number",
            "null"
          ]
        },
        "thresholds": {
          "type": "object",
          "properties": {
            "floor": {
              "type": "number"
            },
            "match": {
              "type": "number"
            },
            "margin": {
              "type": "number"
            }
          }
        }
      },
      "description": "The margin rule's own inputs, so a caller can see WHY it fell where it did."
    },
    "ticker_withheld": {
      "type": "string",
      "description": "The ticker of a FUZZY SEC name match that is NOT asserted, withheld together with `cik_withheld` because it is the same guess. Carried so a caller who meant the US filer can still use it; see `unresolved.ticker`."
    },
    "sec_alternatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cik": {
            "type": "string"
          },
          "ticker": {
            "type": "string"
          },
          "company_name": {
            "type": "string"
          }
        }
      },
      "description": "EDGAR's other name-matching candidates: distinct companies, deduped by CIK, excluding this issuer's own share classes — surfaced instead of dropped so a caller can tell a genuinely CONTESTED name match from a clean one."
    },
    "fanout_incomplete": {
      "type": "object",
      "properties": {
        "unavailable": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string"
              },
              "country": {
                "type": "string"
              },
              "register": {
                "type": "string"
              },
              "register_key": {
                "type": "string"
              }
            }
          }
        },
        "withheld_match": {
          "type": [
            "object",
            "null"
          ]
        }
      },
      "description": "Present IFF at least one register in `searched[]` carried an `error` — set even when `match_status` stayed \"ambiguous\". `withheld_match` is the candidate this call declined to ASSERT because a register was missing, carried rather than discarded so a caller who accepts the caveat can still use it."
    },
    "match_explanation": {
      "type": "string",
      "description": "Plain words. Always present when the spine ran, and required on \"ambiguous\" and \"no_match\"."
    },
    "company_name_withheld": {
      "type": "string",
      "description": "The company name of a FUZZY SEC name match that is NOT asserted, withheld together with `cik_withheld`. See `unresolved.cik`."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "type": "company",
      "values": [
        "AAPL",
        "MSFT"
      ]
    }
  ],
  "required": [
    "type",
    "values"
  ],
  "properties": {
    "type": {
      "enum": [
        "company",
        "drug"
      ],
      "type": "string",
      "description": "Entity type: \"company\" or \"drug\"."
    },
    "values": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 5,
      "minItems": 2,
      "description": "For company: 2–5 tickers/CIKs (e.g., [\"AAPL\",\"MSFT\"]). For drug: 2–5 names (e.g., [\"ozempic\",\"mounjaro\"])."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "type",
    "params"
  ],
  "properties": {
    "type": {
      "enum": [
        "sec_8k",
        "polymarket_edge",
        "fred_series",
        "patent_grant",
        "clinical_trial",
        "form_d",
        "news_keyword",
        "job_post",
        "tool_diff",
        "new_entity",
        "tech_change"
      ],
      "type": "string",
      "description": "Subscription type."
    },
    "params": {
      "type": "object",
      "description": "Type-specific filter. sec_8k: {ticker:\"AAPL\", items?:[\"5.02\",\"1.01\"]}. polymarket_edge: {topic:\"fed\", min_spread_bps?:500}. fred_series: {series_id:\"UNRATE\"}. patent_grant: {applicant:\"Apple Inc.\"}. clinical_trial: {sponsor?:\"Pfizer\", condition?:\"lung cancer\", phase?:\"PHASE3\"} (sponsor or condition required). form_d: {state?:\"CA\", industry?:\"Biotechnology\", min_amount?:500000, exemption?:\"06B\"} (all optional — omit all to watch every new Form D nationwide). news_keyword: {query:\"\\\"semiconductor sanctions\\\"\", lang?:\"eng\", domains?:[\"reuters.com\"]} (query required). job_post: EITHER {ats:\"greenhouse\", board_token:\"acme\"} (exact board) OR {domain:\"acme.com\"} (auto-detected), plus optional title_query/location_query substrings. tool_diff: {tool:\"form5500\", args?:{...}, fields:[\"headcount\"], schedule:\"daily\"} — re-runs that tool on schedule and fires when the named fields change; tool must be read-only and not need a Pipeworx-held platform key; schedule \"hourly\" needs the paid tier. new_entity: {state:\"CO\", name_query?:\"dental\", entity_type?:\"limited liability\"} — state is required and must be one of FL, NY, CO, OR, CT, TX, PA. tech_change: {domains:[\"acme.com\",\"example.org\"], technologies?:[\"Shopify\",\"Segment\"]} — domains required (1-200), technologies optional (exact names, case-insensitive) to narrow which detected technologies alert. Unknown keys in form_d/news_keyword/job_post/tool_diff/new_entity/tech_change params are rejected at subscribe time."
    },
    "delivery": {
      "type": "object",
      "properties": {
        "sms": {
          "type": "string",
          "description": "E.164 phone number, e.g. \"+15551234567\". Must match the account's verified phone."
        },
        "email": {
          "type": "string",
          "description": "Email address to deliver alerts to. Validated against a standard pattern."
        },
        "webhook": {
          "type": "string",
          "description": "HTTPS URL to POST fired events to. https only; localhost/private hosts rejected. Signing secret returned once at subscribe time."
        }
      },
      "description": "Optional delivery channels in addition to the always-on persistent feed. {email:\"you@x.com\"} sends a templated alert per fired event. {sms:\"+15551234567\"} sends an SMS per event — must match the verified phone on the caller's account (verify at https://pipeworx.io/account first; 10/day cap). {webhook:\"https://...\"} POSTs each event JSON to your endpoint, HMAC-signed — the response includes delivery.webhook_secret (whsec_…) ONCE; verify X-Pipeworx-Signature = sha256 HMAC of \"<X-Pipeworx-Timestamp>.<raw body>\". Auto-disabled after 10 consecutive failing runs."
    }
  }
}

{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Subscription id (uuid) returned by subscribe."
    }
  }
}

{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "include_inactive": {
      "type": "boolean",
      "description": "Include cancelled subscriptions in the response (default false)."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "type": {
      "type": "string",
      "description": "Optional — filter to one subscription type."
    },
    "limit": {
      "type": "number",
      "description": "Max events to return (1-200, default 50)."
    },
    "since": {
      "type": "string",
      "description": "Optional ISO timestamp — return events fired_at >= this time."
    },
    "mark_read": {
      "type": "boolean",
      "description": "Flag the returned events read in the same call (default false)."
    },
    "unread_only": {
      "type": "boolean",
      "description": "Return only events where read_at is null (default false)."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "type": "company",
      "value": "AAPL"
    }
  ],
  "required": [
    "type",
    "value"
  ],
  "properties": {
    "type": {
      "enum": [
        "company",
        "ticker"
      ],
      "type": "string",
      "description": "\"company\" or \"ticker\" — both are accepted and behave identically; `value` can be a ticker, CIK, or company name either way. person/place coming soon."
    },
    "value": {
      "type": "string",
      "description": "Ticker (e.g., \"AAPL\"), zero-padded CIK (e.g., \"0000320193\"), or company name (e.g., \"Moderna\"). A NAME now resolves through the national business registers as well as SEC EDGAR, so a non-US company returns its register identity and record rather than `resolved: false`."
    },
    "country": {
      "type": "string",
      "description": "OPTIONAL ISO 3166-1 alpha-2 of the business register you mean (\"NO\", \"FI\", \"GB\", \"JP\", \"FR\", \"EE\", \"BR\"). Only affects a NAME lookup, and is often what separates the company you mean from a US namesake. When a name resolves to a register entity with no CIK, the SEC/CIK-keyed sections are reported under `sources_skipped` with reason `not_queried` — they were never asked, which is not the same as having failed."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "type": "company",
      "since": "30d",
      "value": "AAPL"
    }
  ],
  "required": [
    "type",
    "value",
    "since"
  ],
  "properties": {
    "type": {
      "enum": [
        "company"
      ],
      "type": "string",
      "description": "Entity type. Only \"company\" supported today."
    },
    "since": {
      "type": "string",
      "description": "Window start — ISO date (\"2026-04-01\") or relative (\"7d\", \"30d\", \"3m\", \"1y\"). Use \"30d\" or \"1m\" for typical monitoring."
    },
    "value": {
      "type": "string",
      "description": "Ticker (e.g., \"AAPL\") or zero-padded CIK (e.g., \"0000320193\")."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "claim": "Apple's fiscal 2023 revenue was $383 billion"
    }
  ],
  "required": [
    "claim"
  ],
  "properties": {
    "claim": {
      "type": "string",
      "description": "Natural-language factual claim, e.g., \"Apple's FY2024 revenue was $400 billion\" or \"Microsoft made about $100B in profit last year\"."
    },
    "tolerance_pct": {
      "type": "number",
      "description": "Max percent deviation still graded approximately_correct (0.5–50). Overrides the tolerance implied by the claim wording — set 1–2 for hallucination detection where any material error must be refuted. Default: implied by wording, capped at 5."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "period": {
        "type": "annual",
        "fiscal_year": 2023
      },
      "company": "AAPL",
      "attribute": "revenue"
    },
    {
      "period": {
        "type": "quarterly",
        "fiscal_year": 2026,
        "fiscal_quarter": 2
      },
      "company": "TSLA",
      "attribute": "shares_outstanding"
    },
    {
      "period": {
        "type": "quarterly",
        "fiscal_year": 2026,
        "fiscal_quarter": 2
      },
      "company": "TSLA",
      "attribute": "capex"
    },
    {
      "period": {
        "type": "quarterly",
        "fiscal_year": 2025,
        "fiscal_quarter": 4
      },
      "company": "TSLA",
      "attribute": "net_income"
    }
  ],
  "required": [
    "company",
    "attribute",
    "period"
  ],
  "properties": {
    "as_of": {
      "type": "string",
      "description": "Past ISO timestamp with timezone. Replay the latest answer actually recorded by that instant; no invented history or live fallback."
    },
    "basis": {
      "enum": [
        "consolidated"
      ],
      "type": "string",
      "description": "Only \"consolidated\" in v1. Segment and product-level figures are XBRL-dimensioned and are not reachable through this contract at any concept."
    },
    "period": {
      "type": "object",
      "required": [
        "type",
        "fiscal_year"
      ],
      "properties": {
        "type": {
          "enum": [
            "annual",
            "quarterly"
          ],
          "type": "string",
          "description": "\"annual\" = the full fiscal year. \"quarterly\" = ONE discrete quarter, never a year-to-date figure."
        },
        "fiscal_year": {
          "type": "number",
          "description": "The FILER'S fiscal year — the year the period ends in by their own calendar. Walmart's year ending 2026-01-31 is 2026."
        },
        "fiscal_quarter": {
          "type": "number",
          "description": "1-4. Required when type is \"quarterly\"; rejected when type is \"annual\"."
        }
      },
      "description": "The reporting period, stated explicitly. There is no default and no \"latest\" — that is the point of this tool."
    },
    "company": {
      "type": "string",
      "description": "Ticker (\"AAPL\"), 10-digit CIK (\"0000320193\"), or company name. A name that matches two filers equally well returns status \"ambiguous\" with both named rather than guessing — pass a ticker or CIK to be certain."
    },
    "max_age": {
      "type": "number",
      "maximum": 3155760000,
      "minimum": 0,
      "description": "Maximum age in seconds of the upstream publication, not our fetch. Older or undated facts are withheld."
    },
    "attribute": {
      "enum": [
        "revenue",
        "net_income",
        "cash",
        "gross_profit",
        "operating_income",
        "eps_diluted",
        "capex",
        "operating_cash_flow",
        "long_term_debt",
        "shares_outstanding"
      ],
      "type": "string",
      "description": "Which figure. \"revenue\" = total consolidated revenue; \"net_income\" = net income (loss); \"cash\" = cash and cash equivalents at the period end; \"gross_profit\"; \"operating_income\"; \"eps_diluted\" (diluted EPS, unit USD/shares, never derived or summed); \"capex\" (cash paid for PP&E); \"operating_cash_flow\" (net cash from operating activities); \"long_term_debt\" (the noncurrent balance-sheet line where the filer tags it, else total long-term debt — `fact.measure` says which); \"shares_outstanding\" (dei cover-page common shares, unit \"shares\", as of the COVER DATE rather than the period end)."
    },
    "freshness": {
      "enum": [
        "cached",
        "fresh"
      ],
      "type": "string",
      "description": "cached (default) permits an eligible stored answer; fresh requires an upstream refresh and never silently falls back to stale data."
    },
    "restatement": {
      "enum": [
        "as_amended",
        "as_originally_reported"
      ],
      "type": "string",
      "description": "Default \"as_amended\" — the latest filed figure for the period, with everything it superseded listed. \"as_originally_reported\" takes the first filing instead."
    },
    "exclude_publishers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Publisher ids forbidden for fact retrieval: sec, fmp, alphavantage. Case and surrounding whitespace are normalized; unknown ids are refused. Excluding sec currently leaves no eligible fact source and returns unavailable/sources_excluded with the selection reasons. Identity and fiscal-calendar lookups may still use SEC; no excluded financial concept is fetched."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "name": "Equinor ASA",
      "country": "NO"
    },
    {
      "name": "株式会社花王",
      "country": "JP"
    },
    {
      "name": "Bolt",
      "country": "EE"
    }
  ],
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The company name as you have it, in its own script. Pass it VERBATIM — do not strip the legal form (\"Oyj\", \"AS\", \"株式会社\", \"Ltd\"): in Japanese the form is a PREFIX as often as a suffix and 株式会社花王 and 花王株式会社 are DIFFERENT companies, so the form is often the only evidence that separates two candidates. Diacritics, full-width characters and kana are all handled."
    },
    "limit": {
      "type": "number",
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum candidates to return, 1-50 (default 10). Does not change which registers are asked, only how many rivals come back."
    },
    "country": {
      "type": "string",
      "description": "OPTIONAL ISO 3166-1 alpha-2 of the register you mean (\"GB\", \"NO\", \"FI\", \"FR\", \"JP\", \"EE\", \"BR\"). Narrows the fan-out, and is frequently the difference between an answer and `ambiguous` on a short name. The GLEIF crosswalk is asked whatever you pass, because for several jurisdictions it is the only register we can name at all."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "package": "left-pad"
    }
  ],
  "required": [
    "package"
  ],
  "properties": {
    "package": {
      "type": "string",
      "description": "npm package name. Scoped packages (e.g. \"@types/node\") are accepted."
    },
    "version": {
      "type": "string",
      "description": "Specific version to check (e.g., \"18.3.1\"). Defaults to the latest published version when omitted."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "market": "will-kristi-noem-win-the-2028-republican-presidential-nomination"
    },
    {
      "market": "https://polymarket.com/event/will-kristi-noem-win-the-2028-republican-presidential-nomination"
    }
  ],
  "required": [
    "market"
  ],
  "properties": {
    "depth": {
      "enum": [
        "quick",
        "thorough"
      ],
      "type": "string",
      "description": "quick = 2-3 evidence sources, thorough = full fan-out. Default thorough."
    },
    "market": {
      "type": "string",
      "description": "Polymarket slug (\"will-kristi-noem-win-the-2028-republican-presidential-nomination\"), full URL (\"https://polymarket.com/event/...\"), or question text (\"Will Bitcoin hit $150k?\"). Dated slugs still resolve after they settle — the resolver retries a closed-market lookup — so either a dated or undated slug works."
    },
    "include_raw": {
      "type": "boolean",
      "description": "Default false. When false (recommended), FRED/FDA/GDELT/Federal-Register evidence is summarized to the few fields agents actually use — keeps responses under ~20KB. Pass true to get full upstream payloads (50KB-500KB) when you need to recompute deltas, cite specific observations, or post-process."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "topic": "Fed rate decision"
    }
  ],
  "properties": {
    "event": {
      "type": "string",
      "description": "Single-event mode (use this if you know the specific Polymarket event): event slug like \"fed-decision-may-2026\" or \"when-will-bitcoin-hit-150k\". Full Polymarket URLs also accepted."
    },
    "topic": {
      "type": "string",
      "description": "Cross-event mode (use this if you want to scan related events across the platform): a topic or seed question like \"Fed rate decision\" or \"Strait of Hormuz traffic returns to normal\". Tool searches Polymarket for related events and checks monotonicity across them."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "limit": 5,
      "window": "1wk"
    }
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Top N edges to return after ranking. Default 10, max 25."
    },
    "window": {
      "enum": [
        "24hr",
        "1wk",
        "1mo"
      ],
      "type": "string",
      "description": "Polymarket volume window to filter markets. Default 1wk."
    },
    "min_kelly": {
      "type": "number",
      "description": "Minimum half-Kelly fraction (as decimal, e.g. 0.005 = 0.5% of bankroll) to include single-leg opportunities. Default 0 (no filter). Skips opportunities that are too small to bet sensibly even if the edge is large."
    },
    "min_edge_pp": {
      "type": "number",
      "description": "Minimum |edge| in percentage points to include (default 0.5). Edge is evaluated NET of slippage and Polymarket's own taker fee."
    },
    "slippage_pp": {
      "type": "number",
      "description": "Assumed execution slippage in percentage points per leg (default 0.3), for bid/ask + thin depth cost that a last-trade price does not show. Subtracted from raw |edge| before ranking and Kelly sizing, ON TOP OF Polymarket's own taker fee — which is NOT zero (rate 0.04-0.07 depending on category, read off each market's own published fee schedule; see fees_pp_applied on every row and fees.ts for the full schedule). Bump slippage for very thin partitions; drop to 0 if you have a smarter fill model — the fee still applies regardless."
    },
    "max_spread_pp": {
      "type": "number",
      "description": "Tradeable-edge filter. Maximum bid/ask spread in percentage points on the representative market. Default null (no filter). Set to 2 to require tight books — anything wider eats most plausible edges."
    },
    "min_liquidity": {
      "type": "number",
      "description": "Tradeable-edge filter. Minimum $ liquidity on the representative market (or for partition_overround, on at least one top_leg). Default 0 (no filter). Set to 5000 to drop thin-book opportunities where executing the edge would walk the book past breakeven."
    },
    "category_filter": {
      "type": "string",
      "description": "Comma-separated list to restrict the output: \"model_driven\" (crypto_price + news_momentum), \"structural_arbitrage\" (partition_overround), \"concentrated_longshot\". Combine like \"model_driven,structural_arbitrage\". Default: all."
    },
    "min_partition_leg_kelly": {
      "type": "number",
      "description": "Minimum BEST per-leg half-Kelly fraction across a partition_overround opportunity's top_legs (or longshot_basket legs). Default 0 (no filter). Partition arbs always return kelly_fraction_half=0 at the parent level by design (basket trades don't compose to single-leg Kelly), so min_kelly never filters them — this knob applies to the per-leg Kelly inside top_legs instead. Use to suppress thin partitions whose individual leg edges aren't worth the per-leg slippage cost."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "topic": "fed"
    },
    {
      "topic": "btc"
    },
    {
      "topic": "bitcoin"
    },
    {
      "topic": "fed rate decision"
    },
    {
      "topic": "btc 15m"
    }
  ],
  "properties": {
    "topic": {
      "type": "string",
      "description": "Subject to compare. Canonical keys: fed | btc | eth | cpi | gdp | sp500 | recession | next_pope | next_uk_pm | next_israel_pm | 2028_president — plus the 15-minute crypto up/down windows btc_15m | eth_15m | sol_15m | xrp_15m | bnb_15m (\"btc 15m\", \"bitcoin 15 minute\"), which are answered by updown_venue_compare for the window in progress — but aliases and keywords resolve too (\"bitcoin\", \"fed rate decision\", \"ethereum\", \"inflation\", \"s&p 500\", \"us recession\", \"next pope\", \"2028 election\"). Check resolution.topic_matched_by in the response: \"exact\"/\"alias\" is a curated pairing, \"phrase\"/\"token\" is a keyword guess."
    },
    "kalshi_event_ticker": {
      "type": "string",
      "description": "Explicit Kalshi event ticker, e.g. \"KXFED-26OCT\". Overrides the topic-mapped Kalshi side."
    },
    "polymarket_event_slug": {
      "type": "string",
      "description": "Explicit Polymarket event slug, e.g. \"fed-decision-in-june-825\". Overrides the topic-mapped Polymarket side."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "side": "buy_yes",
      "market": "will-the-fed-increase-interest-rates-by-25-bps-after-the-december-2026-meeting-20260729232808636",
      "size_usd": 1000
    }
  ],
  "properties": {
    "side": {
      "type": "string",
      "description": "Single-market: buy_yes | sell_yes | buy_no | sell_no (default buy_yes). Basket: sell_yes | buy_yes (default auto — sell if partition sum > 1, buy if < 1)."
    },
    "event": {
      "type": "string",
      "description": "Basket mode: event slug or full polymarket.com URL — checks every leg of the partition."
    },
    "market": {
      "type": "string",
      "description": "Single-market mode: market slug or full polymarket.com URL."
    },
    "size_usd": {
      "type": "number",
      "description": "Single-market: USD to spend (buys) or target proceeds (sells). Basket: settlement notional — shares per leg, each paying $1 at resolution. Default 1000, clamp 10–1,000,000."
    }
  }
}

{
  "type": "object",
  "properties": {
    "mode": {
      "enum": [
        "single_market",
        "basket"
      ],
      "type": "string",
      "description": "Which mode answered — set by which of market/event was passed."
    },
    "side": {
      "type": "string",
      "description": "Single-market mode: the side actually priced (buy_yes|sell_yes|buy_no|sell_no)."
    },
    "_hint": {
      "type": "string",
      "description": "Usage note — what is gross vs net of fees, and what is still unmodeled."
    },
    "error": {
      "type": "string",
      "description": "Error code (orderbook_unavailable, event_books_unavailable, empty_book, bad_side, missing_input) — present only on failure."
    },
    "event": {
      "type": "string",
      "description": "Basket mode: resolved event slug."
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Basket mode: event title."
    },
    "fee_pp": {
      "type": "number",
      "description": "Single-market mode: the taker fee as a percentage point of a $1 share — size-invariant, so it's the same number at any trade size."
    },
    "market": {
      "type": "string",
      "description": "Single-market mode: resolved market slug."
    },
    "fee_usd": {
      "type": "number",
      "description": "Single-market mode: Polymarket taker fee in USD on the shares actually filled."
    },
    "message": {
      "type": "string",
      "description": "Human-readable error detail — present only on failure."
    },
    "per_leg": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "fee_usd": {
            "type": "number",
            "description": "This leg's own Polymarket taker fee in USD at the executed size."
          },
          "question": {
            "type": [
              "string",
              "null"
            ]
          },
          "slippage_pp": {
            "type": [
              "number",
              "null"
            ]
          },
          "top_of_book": {
            "type": [
              "number",
              "null"
            ]
          },
          "depth_shares": {
            "type": "number"
          },
          "fills_requested_size": {
            "type": "boolean"
          },
          "vwap_at_executed_size": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      },
      "description": "Basket mode: per-leg fill detail."
    },
    "verdict": {
      "enum": [
        "clean",
        "degraded",
        "cannot_fill"
      ],
      "type": "string",
      "description": "Single-market mode: fill-quality verdict based on depth/slippage (independent of the fee)."
    },
    "question": {
      "type": [
        "string",
        "null"
      ],
      "description": "Single-market mode: the market question."
    },
    "strategy": {
      "enum": [
        "sell_yes_every_leg",
        "buy_yes_every_leg"
      ],
      "type": "string",
      "description": "Basket mode: which side was priced across every leg."
    },
    "dead_legs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Basket mode: leg slugs with zero visible depth on the priced side."
    },
    "leg_count": {
      "type": "number",
      "description": "Basket mode: number of legs priced."
    },
    "reasoning": {
      "type": "string",
      "description": "Plain-English explanation of the verdict, naming the all-in cost and breakeven."
    },
    "thin_legs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Basket mode: leg slugs that cannot cleanly absorb the requested size."
    },
    "usd_filled": {
      "type": "number",
      "description": "Single-market mode: dollars actually fillable from visible depth."
    },
    "slippage_pp": {
      "type": [
        "number",
        "null"
      ],
      "description": "Single-market mode: |vwap - top_of_book| in percentage points."
    },
    "theoretical": {
      "type": "object",
      "properties": {
        "basis": {
          "type": "string"
        },
        "edge_pp": {
          "type": "number"
        },
        "sum_yes": {
          "type": "number"
        }
      },
      "description": "Basket mode: top-of-book sum across all legs, before depth."
    },
    "top_of_book": {
      "type": "number",
      "description": "Single-market mode: best price on the side priced."
    },
    "fee_schedule": {
      "type": "object",
      "properties": {
        "basis": {
          "enum": [
            "payload",
            "category",
            "fallback",
            "fee_free"
          ],
          "type": "string",
          "description": "Where the rate came from — payload (read off this market) is the most trustworthy."
        },
        "category": {
          "type": [
            "string",
            "null"
          ],
          "description": "Polymarket's fee category, e.g. 'crypto_fees_v2'."
        },
        "exponent": {
          "type": "number",
          "description": "Exponent in fee = shares × rate × (p×(1-p))^exponent — 1 on every market observed."
        },
        "taker_rate": {
          "type": "number",
          "description": "Taker-fee rate actually applied (0 means genuinely fee-free, never \"unknown\")."
        },
        "fees_enabled": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "false means this market genuinely charges no taker fee."
        },
        "maker_rebate_rate": {
          "type": [
            "number",
            "null"
          ],
          "description": "Polymarket's published maker rebate rate, when known."
        }
      },
      "description": "Polymarket's published taker-fee parameters for this market, read off the market payload (fleet #3446) — never assumed fee-free."
    },
    "capture_ratio": {
      "type": [
        "number",
        "null"
      ],
      "description": "Basket mode: fraction of the theoretical edge that survives depth AND fees (fleet #3446 — was gross of fees before)."
    },
    "shares_filled": {
      "type": "number",
      "description": "Single-market mode: shares actually fillable from visible depth."
    },
    "all_in_cost_pp": {
      "type": [
        "number",
        "null"
      ],
      "description": "Single-market mode: slippage_pp + fee_pp — the full round-trip cost of this fill."
    },
    "truncated_legs": {
      "type": "number",
      "description": "Basket mode: legs dropped by the 80-leg cap, if any."
    },
    "vwap_fill_price": {
      "type": [
        "number",
        "null"
      ],
      "description": "Single-market mode: volume-weighted fill price across the requested size; null if nothing filled."
    },
    "max_fillable_usd": {
      "type": "number",
      "description": "Single-market mode: total USD value of the entire visible side of the book."
    },
    "partition_complete": {
      "type": "boolean",
      "description": "Basket mode: false means truncated_legs > 0 — edge figures are directional only."
    },
    "side_auto_selected": {
      "type": "boolean",
      "description": "Basket mode: true if side was inferred from the partition sum rather than passed explicitly."
    },
    "size_usd_requested": {
      "type": "number",
      "description": "Single-market mode: the size_usd argument, clamped."
    },
    "book_levels_visible": {
      "type": "number",
      "description": "Single-market mode: count of price levels on the side priced."
    },
    "capture_ratio_gross": {
      "type": [
        "number",
        "null"
      ],
      "description": "Basket mode: the pre-fee figure capture_ratio used to report."
    },
    "forced_directional_risk": {
      "type": "string",
      "description": "Basket mode: plain-English risk note naming dead/thin legs."
    },
    "breakeven_win_rate_maker": {
      "type": "number",
      "description": "Single-market mode: win-rate a maker (no taker fee charged) would need — equals top_of_book."
    },
    "breakeven_win_rate_taker": {
      "type": [
        "number",
        "null"
      ],
      "description": "Single-market mode: win-rate (0-1) the filled side needs to break even as a taker, INCLUDING the fee — always worse than the raw fill price."
    },
    "realizable_at_executed_size": {
      "type": "object",
      "properties": {
        "note": {
          "type": "string",
          "description": "Present only when the basket is not executable at any size."
        },
        "edge_pp": {
          "type": [
            "number",
            "null"
          ]
        },
        "sum_yes": {
          "type": [
            "number",
            "null"
          ]
        },
        "profit_usd": {
          "type": "number",
          "description": "NET of every leg's own Polymarket taker fee."
        },
        "fees_usd_total": {
          "type": "number",
          "description": "Sum of per_leg[].fee_usd across every leg."
        },
        "profit_usd_gross": {
          "type": "number",
          "description": "Before fees — kept alongside profit_usd so the fee cost is never hidden."
        }
      },
      "description": "Basket mode: VWAP sum across all legs at the executed size, net of each leg's own Polymarket taker fee (fleet #3446 — profit_usd was gross before)."
    },
    "scaled_down_by_thinnest_leg": {
      "type": "boolean",
      "description": "Basket mode: true if executed size was capped below the requested size."
    },
    "settlement_notional_executed_usd": {
      "type": "number",
      "description": "Basket mode: shares-per-leg actually executable, scaled down by the thinnest leg."
    },
    "settlement_notional_requested_usd": {
      "type": "number",
      "description": "Basket mode: requested shares-per-leg (the size_usd argument)."
    }
  },
  "description": "Realizable fill risk against live order-book depth, plus Polymarket's own taker fee and the breakeven win-rate it implies (fleet #3446)."
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "days": 14,
      "window": "1wk"
    }
  ],
  "properties": {
    "days": {
      "type": "number",
      "description": "Lookback in days (default 14, clamp 2-30)."
    },
    "window": {
      "type": "string",
      "description": "Which polymarket_edges window family to read snapshots for: 24hr | 1wk | 1mo (default 1wk)."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "city": "nyc"
    },
    {
      "city": "chicago"
    },
    {
      "backtest_days": 14,
      "series_ticker": "KXHIGHNY"
    }
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City to price, e.g. \"nyc\", \"chicago\", \"los angeles\", \"miami\", \"austin\", \"houston\", \"denver\", \"philadelphia\". Defaults to nyc. Unmapped cities return known_cities[] rather than a wrong series."
    },
    "date": {
      "type": "string",
      "description": "Settlement date as YYYY-MM-DD. Defaults to the soonest open event. Daily weather markets open ~1-2 days ahead and close 05:00Z the next day."
    },
    "market_type": {
      "type": "string",
      "description": "\"high_temp\" (default) | \"precip\". Precipitation markets return prices but no forecast_prob yet."
    },
    "backtest_days": {
      "type": "number",
      "description": "Run measurement mode over the last N settled days (max 60) instead of pricing today. Returns brier_market vs brier_forecast, the settlement-vs-forecast basis, and per-day detail. Both sides are scored at 12:00Z on each event day — before the daily high and before resolution — because a settled market prices the known outcome at close."
    },
    "series_ticker": {
      "type": "string",
      "description": "Explicit Kalshi series, e.g. \"KXHIGHNY\" or \"KXHIGHTBOS\" (Boston). Overrides `city`; use it for any of the 121 daily weather series not in the city list."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "venue": "polymarket",
      "market": "bitcoin-above-70k-on-september-13-2026"
    },
    {
      "venue": "kalshi",
      "market": "KXBTCD-26SEP1317"
    }
  ],
  "required": [
    "venue",
    "market"
  ],
  "properties": {
    "venue": {
      "enum": [
        "polymarket",
        "kalshi",
        "polymarket-us"
      ],
      "type": "string",
      "description": "Which venue to fetch the market from. \"polymarket\" is the offshore venue (polymarket.com); \"polymarket-us\" is the separate, CFTC-regulated polymarket.us venue, matched by slug via its own search (no exact-slug lookup exists upstream)."
    },
    "market": {
      "type": "string",
      "description": "Polymarket (.com or .us) market slug or URL, OR a Kalshi market ticker (preferred) or event ticker (falls back to a representative market under that event)."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "a": {
        "venue": "polymarket",
        "market": "bitcoin-above-70k-on-september-13-2026"
      },
      "b": {
        "venue": "kalshi",
        "market": "KXBTCD-26SEP1317"
      }
    }
  ],
  "required": [
    "a",
    "b"
  ],
  "properties": {
    "a": {
      "type": "object",
      "required": [
        "venue",
        "market"
      ],
      "properties": {
        "venue": {
          "enum": [
            "polymarket",
            "kalshi",
            "polymarket-us"
          ],
          "type": "string"
        },
        "market": {
          "type": "string"
        }
      },
      "description": "First market to compare."
    },
    "b": {
      "type": "object",
      "required": [
        "venue",
        "market"
      ],
      "properties": {
        "venue": {
          "enum": [
            "polymarket",
            "kalshi",
            "polymarket-us"
          ],
          "type": "string"
        },
        "market": {
          "type": "string"
        }
      },
      "description": "Second market to compare."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "hours": 72
    },
    {
      "hours": 100,
      "categories": "econ,fed"
    }
  ],
  "properties": {
    "hours": {
      "type": "number",
      "description": "Look-ahead window in hours from now. Default 48. Capped at 720 (30 days) — econ/fed releases are dated weeks apart, so a short window is often empty; widen rather than assume nothing is scheduled."
    },
    "categories": {
      "type": "string",
      "description": "Comma or space separated subset of econ|fed|fda|sec|court, or \"all\" (default). E.g. \"econ,fed\" or \"fda\"."
    }
  }
}

{
  "type": "object",
  "properties": {
    "hint": {
      "type": "string",
      "description": "Present ONLY on a zero-release window: what to change (usually a wider `hours`)."
    },
    "as_of": {
      "type": "string"
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "window": {
      "type": "object",
      "properties": {
        "hours": {
          "type": "number"
        },
        "since": {
          "type": "string"
        },
        "until": {
          "type": "string"
        }
      }
    },
    "releases": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "markets": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "price": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "venue": {
                  "enum": [
                    "kalshi",
                    "polymarket"
                  ],
                  "type": "string"
                },
                "volume": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "question": {
                  "type": "string"
                },
                "matched_by": {
                  "type": "string"
                },
                "slug_or_ticker": {
                  "type": "string"
                },
                "hours_to_release": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "resolves_on_this_release": {
                  "enum": [
                    "true",
                    "likely",
                    "unclear"
                  ],
                  "type": "string"
                }
              }
            }
          },
          "release": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "category": {
                "enum": [
                  "econ",
                  "fed",
                  "fda",
                  "sec",
                  "court"
                ],
                "type": "string"
              },
              "date_only": {
                "type": "boolean"
              },
              "source_pack": {
                "type": "string"
              },
              "source_tool": {
                "type": "string"
              },
              "time_source": {
                "type": "string"
              },
              "scheduled_at": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "et": {
                    "type": "string"
                  },
                  "utc": {
                    "type": "string"
                  }
                }
              },
              "hours_to_release": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "what_it_publishes": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "empty_reason": {
      "type": "string",
      "description": "Present ONLY on a zero-release window: \"no_releases_in_window\". The window was queried and nothing is scheduled — this is an answer, not a failure."
    },
    "release_count": {
      "type": "number"
    },
    "releases_with_matched_markets": {
      "type": "number"
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "asset": "btc",
      "venue": "polymarket",
      "minute": 5,
      "horizon": "15m"
    },
    {
      "asset": "btc",
      "venue": "all",
      "minute": 5,
      "bucket_pp": 10
    },
    {
      "asset": "btc",
      "venue": "kalshi",
      "side_convention": "favorite"
    }
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "btc (default) | eth | sol | xrp | bnb. Coverage differs by venue: polymarket and polymarket-us carry btc/eth/sol/xrp, Kalshi carries btc/eth/bnb."
    },
    "venue": {
      "type": "string",
      "description": "polymarket | polymarket-us | kalshi | all (default polymarket). \"all\" returns one grid per venue, never a merged one."
    },
    "minute": {
      "type": "number",
      "description": "Minutes elapsed since window open, 0-based. Omit for the full grid; pass 5 for the \"five minutes in\" row only, which is also the cheapest query."
    },
    "horizon": {
      "type": "string",
      "description": "15m (default). 5m | 1h | 1d are accepted but only 15m is collected today, so another value returns coverage.windows_total 0 rather than an error."
    },
    "bucket_pp": {
      "type": "number",
      "description": "Price-bucket width in percentage points: 5 | 10 (default) | 20 | 25 | 50. Must divide 100, so the last bucket is never narrower than the rest."
    },
    "side_convention": {
      "type": "string",
      "description": "\"favorite\" (default) folds each window onto whichever side was the favorite — the frame published claims about early favorites use. \"yes\" keeps the venue own YES/Up side."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "asset": "btc",
      "window": "current",
      "horizon": "15m"
    },
    {
      "asset": "eth",
      "window": "previous"
    },
    {
      "asset": "btc",
      "window": "2026-10-27T14:30:00Z"
    }
  ],
  "required": [],
  "properties": {
    "asset": {
      "type": "string",
      "description": "btc (default) | eth | sol | xrp | bnb. Coverage differs by venue; a venue that does not list the asset answers not_listed."
    },
    "window": {
      "type": "string",
      "description": "\"current\" (default), \"next\", \"previous\", or the window START as an ISO-8601 timestamp on a 15-minute boundary, e.g. 2026-10-27T14:15:00Z. An unaligned timestamp is refused, not rounded."
    },
    "horizon": {
      "type": "string",
      "description": "15m (default and the only value offered)."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "days": 30,
      "asset": "btc"
    },
    {
      "days": 14,
      "asset": "eth"
    }
  ],
  "required": [],
  "properties": {
    "days": {
      "type": "number",
      "description": "Look-back in days, 1-90 (default 30). The archive starts 2026-09-22 (polymarket.com, Kalshi) and 2026-10-07 (Polymarket US, btc), so a longer span is capped by what is held; coverage is reported per pair."
    },
    "asset": {
      "type": "string",
      "description": "btc (default) | eth | sol | xrp | bnb. The archive holds btc/eth on all three venues, sol/xrp on polymarket.com and Polymarket US, bnb on Kalshi only (no pair)."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "url": "https://www.sec.gov",
      "date": "2023-06-01"
    },
    {
      "url": "https://www.sec.gov",
      "date": "2023-06-01",
      "max_chars": 400
    }
  ],
  "required": [
    "url",
    "date"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "The page address, e.g. \"https://www.sec.gov\" or \"https://www.ftc.gov/policy-notices/privacy-policy\"."
    },
    "date": {
      "type": "string",
      "description": "The date to look up, as YYYY-MM-DD (e.g. \"2023-06-01\"), YYYYMMDD, or a full ISO timestamp."
    },
    "max_chars": {
      "type": "number",
      "description": "Characters of page text to return. Default 12000, max 60000."
    },
    "max_gap_days": {
      "type": "number",
      "description": "Furthest a capture may be from the date and still be used, in days. Default 30, max 3650."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "url": "https://www.ftc.gov/policy-notices/privacy-policy",
      "date_a": "2022-06-02",
      "date_b": "2024-06-15"
    }
  ],
  "required": [
    "url",
    "date_a",
    "date_b"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "The page address, e.g. \"https://www.ftc.gov/policy-notices/privacy-policy\"."
    },
    "date_a": {
      "type": "string",
      "description": "The earlier date, as YYYY-MM-DD (e.g. \"2021-06-01\")."
    },
    "date_b": {
      "type": "string",
      "description": "The later date, as YYYY-MM-DD (e.g. \"2024-06-01\")."
    },
    "max_gap_days": {
      "type": "number",
      "description": "Furthest a capture may be from each date and still be used, in days. Default 30, max 3650."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "entity": {
        "name": "Stripe",
        "domain": "stripe.com"
      },
      "sources": "web",
      "max_cost": 0.02,
      "question": "Does this company sell to healthcare, and who is the head of sales?",
      "output_schema": {
        "properties": {
          "head_of_sales": {
            "type": "string"
          },
          "sells_to_healthcare": {
            "type": "boolean"
          }
        }
      }
    }
  ],
  "required": [
    "entity",
    "question",
    "output_schema"
  ],
  "properties": {
    "entity": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Company name, e.g. \"Acme Robotics\"."
        },
        "domain": {
          "type": "string",
          "description": "Company website domain, e.g. \"acme.com\" (with or without https://). Required to use sources:\"web\"."
        }
      },
      "description": "The row/company to research. At least one of name/domain required."
    },
    "sources": {
      "enum": [
        "catalog",
        "web",
        "both"
      ],
      "type": "string",
      "description": "Where to look: \"web\" (company site only), \"catalog\" (entity_profile only), \"both\" (default)."
    },
    "max_cost": {
      "type": "number",
      "description": "Cost ceiling in US dollars for this one row. Default 0.02, max 0.50, minimum viable 0.002 (below that the call is refused rather than silently exceeding it)."
    },
    "question": {
      "type": "string",
      "description": "The question to answer about this company, in natural language, e.g. \"Does this company sell to healthcare, and who is the head of sales?\""
    },
    "output_schema": {
      "type": "object",
      "description": "JSON Schema object naming the fields to extract, e.g. {\"properties\":{\"sells_to_healthcare\":{\"type\":\"boolean\"},\"head_of_sales\":{\"type\":\"string\"}}}. Up to 20 fields."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "entity": {
        "name": "Stripe",
        "domain": "stripe.com"
      },
      "labels": [
        "healthcare",
        "fintech",
        "logistics"
      ]
    }
  ],
  "required": [
    "entity",
    "labels"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Text to classify directly (a description, a page you already fetched, etc.) — cheapest path, skips any fetch."
    },
    "entity": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Company name, e.g. \"Acme Robotics\"."
        },
        "domain": {
          "type": "string",
          "description": "Company website domain — used to fetch the homepage ONLY when text is not provided."
        }
      },
      "description": "The row/company to classify. At least one of name/domain required."
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Candidate labels to test, 2-30 strings, e.g. [\"healthcare\",\"fintech\",\"logistics\"]."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "window": "7d"
    }
  ],
  "properties": {
    "window": {
      "enum": [
        "24h",
        "7d",
        "30d"
      ],
      "type": "string",
      "description": "24h (default) | 7d | 30d. Shorter windows surface what's hot right now; longer windows show steady-state demand."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "topic": "finance"
    }
  ],
  "properties": {
    "topic": {
      "type": "string",
      "description": "Optional focus area: finance | pharma | economics | real-estate | betting | weather | government | science | news. Omit for a cross-category spread."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "url": "https://pipeworx.io"
    }
  ],
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL of the site to summarize, e.g. \"https://example.com\" or a specific landing page."
    },
    "max_links": {
      "type": "number",
      "description": "Maximum number of link entries to include (default 25, max 50)."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "entity": "Tesla"
    }
  ],
  "required": [
    "entity"
  ],
  "properties": {
    "entity": {
      "type": "string",
      "description": "The thing to ask about. Brand/business name, product name, person, or topic. E.g. \"Pipeworx\", \"OpenInvoice\", \"Acme Corp pricing\"."
    },
    "models": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Which models to probe. Supported: \"workers-ai\" (free default), \"anthropic\" (requires _apiKey). Omit for just workers-ai."
    },
    "_apiKey": {
      "type": "string",
      "description": "Optional Anthropic API key (sk-ant-...) — only needed if \"anthropic\" is in models. Passed straight through to api.anthropic.com."
    },
    "context": {
      "type": "string",
      "description": "Optional: a phrase locating the entity (e.g. \"Boston restaurant\", \"B2B SaaS\"). Helps disambiguate common names."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "entities": [
        "Pipeworx",
        "Zapier"
      ]
    }
  ],
  "required": [
    "entities"
  ],
  "properties": {
    "models": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Which models to probe. Supported: \"workers-ai\" (free default), \"anthropic\" (requires _apiKey). Omit for just workers-ai."
    },
    "_apiKey": {
      "type": "string",
      "description": "Optional Anthropic API key — only if \"anthropic\" is in models. Passed to api.anthropic.com per probe."
    },
    "context": {
      "type": "string",
      "description": "Optional shared context applied to every probe (e.g. \"B2B SaaS\", \"Boston restaurant\"). Disambiguates common names."
    },
    "entities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of 2-8 entities to compare (brand/business/product names). First entry treated as the \"subject\" for narrative; rest are competitors."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "type": "other",
      "message": "Fleet #2184 smoke test: verifying pipeworx_feedback example call returns non-empty."
    }
  ],
  "properties": {
    "type": {
      "enum": [
        "bug",
        "feature",
        "data_gap",
        "praise",
        "other"
      ],
      "type": "string",
      "description": "bug = something broke or returned wrong data. feature = a new tool or capability you wish existed. data_gap = data Pipeworx does not currently expose. praise = positive note. other = anything else."
    },
    "context": {
      "type": "object",
      "properties": {
        "pack": {
          "type": "string",
          "description": "Pack slug (e.g., \"fred\")"
        },
        "tool": {
          "type": "string",
          "description": "Tool name (e.g., \"fred_get_series\")"
        },
        "vertical": {
          "type": "string",
          "description": "Vertical (e.g., \"housing\")"
        }
      },
      "description": "Optional structured context: which tool, pack, or vertical this relates to."
    },
    "message": {
      "type": "string",
      "description": "Your feedback in plain text. Be specific (which tool, what error, what data was missing). 1-2 sentences typical, 2000 chars max."
    },
    "claim_token": {
      "type": "string",
      "description": "Read the reply to a report you filed earlier: pass the `pwfb_…` token that filing returned, with no other arguments. Returns the status and, once resolved, what actually changed."
    }
  }
}

{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "key": "target_ticker",
      "value": "AAPL"
    }
  ],
  "required": [
    "key",
    "value"
  ],
  "properties": {
    "k": {
      "type": "string",
      "description": "Alias for key."
    },
    "v": {
      "type": "string",
      "description": "Alias for value."
    },
    "key": {
      "type": "string",
      "description": "Memory key (e.g., \"subject_property\", \"target_ticker\", \"user_preference\"). Accepts name, k, label as aliases."
    },
    "data": {
      "type": "string",
      "description": "Alias for value."
    },
    "name": {
      "type": "string",
      "description": "Alias for key."
    },
    "text": {
      "type": "string",
      "description": "Alias for value."
    },
    "label": {
      "type": "string",
      "description": "Alias for key."
    },
    "value": {
      "type": "string",
      "description": "Value to store (any text — findings, addresses, preferences, notes). Accepts content, text, data, v as aliases; a non-string value is stored as JSON."
    },
    "content": {
      "type": "string",
      "description": "Alias for value."
    }
  }
}

{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "key": "user_research_topic"
    },
    {}
  ],
  "required": [],
  "properties": {
    "k": {
      "type": "string",
      "description": "Alias for key."
    },
    "key": {
      "type": "string",
      "description": "Memory key to retrieve (omit to list all keys). Accepts name, k, label as aliases."
    },
    "name": {
      "type": "string",
      "description": "Alias for key."
    },
    "label": {
      "type": "string",
      "description": "Alias for key."
    }
  }
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "key": "user_research_topic"
    }
  ],
  "required": [
    "key"
  ],
  "properties": {
    "k": {
      "type": "string",
      "description": "Alias for key."
    },
    "key": {
      "type": "string",
      "description": "Memory key to delete. Accepts name, k, label as aliases."
    },
    "name": {
      "type": "string",
      "description": "Alias for key."
    },
    "label": {
      "type": "string",
      "description": "Alias for key."
    }
  }
}

{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": true
}

{
  "type": "object",
  "examples": [
    {
      "year": 2022,
      "condition": "heart failure"
    }
  ],
  "properties": {
    "year": {
      "enum": [
        2022,
        2017
      ],
      "type": "number",
      "description": "Statistical Brief edition year. One of: 2022, 2017. Defaults to 2022 (the most recent AHRQ has published)."
    },
    "payer": {
      "enum": [
        "all",
        "medicare",
        "medicaid",
        "private_insurance",
        "self_pay"
      ],
      "type": "string",
      "description": "Expected payer to filter by. Only 2022 has per-payer tables; other years return the all-payer table regardless of this argument."
    },
    "condition": {
      "type": "string",
      "description": "Condition name (e.g. \"heart failure\", \"sepsis\", \"stroke\") or CCSR code (e.g. \"CIR019\") to filter to. Omit to get the full top-20 table for that year/payer."
    }
  }
}

{
  "cost": {
    "all": 1
  },
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

{
  "type": "object",
  "examples": [
    {
      "period": "y2021",
      "population": "all"
    }
  ],
  "properties": {
    "period": {
      "enum": [
        "avg_2016_2019",
        "y2020",
        "y2020_with_covid",
        "y2020_without_covid",
        "y2021",
        "y2021_with_covid",
        "y2021_without_covid"
      ],
      "type": "string",
      "description": "Reporting period. \"y2021\" is the full-year 2021 estimate (with and without a co-occurring COVID-19 diagnosis combined). Defaults to \"y2021\"."
    },
    "population": {
      "enum": [
        "all",
        "adult_65_plus_nonmaternal",
        "adult_18_64_nonmaternal",
        "maternal",
        "pediatric_28days_17years",
        "neonatal_0_27days"
      ],
      "type": "string",
      "description": "Patient population. Defaults to \"all\"."
    }
  }
}

{
  "cost": {
    "all": 1
  },
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

pipeworx://fred/series/{series_id}

pipeworx://fred/series/{series_id}/observations

pipeworx://clinicaltrials/study/{nct_id}

pipeworx://rxnorm/concept/{rxcui}

pipeworx://uspto/patent/{number}

pipeworx://edgar/company/{ticker_or_cik}/filings

pipeworx://edgar/company/{cik}/facts

pipeworx://edgar/company/{cik}/facts/{concept}

pipeworx://edgar/company/{cik}/filings/{accession}

pipeworx://edgar/company/{cik}

pipeworx://gleif/lei/{lei}

pipeworx://federal-register/document/{number}

pipeworx://semanticscholar/paper/{paper_id}

pipeworx://openalex/work/{work_id}

pipeworx://wikipedia/article/{title}

pipeworx://gutenberg/book/{book_id}