Skip to main content

Ingestion Rules

MCP tools for the Ingestion Rules module. See the Ingestion Rules module docs for permissions and data model.

list-ingestion-rules​

List ingestion rules

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject ID (required if not using project key auth)
limitnumbernoNumber of results per page
offsetnumbernoNumber of results to skip

create-ingestion-rule​

Create an ingestion rule

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject ID (required if not using project key auth)
content_type_globstringyesMIME type glob matched against a file's content_type. At most 4 wildcards and 255 characters — a MIME glob needs one on each side of the slash at most.
tool_idstringnoConverter tool id (mutually exclusive with agent_id)
agent_idstringnoConverter agent id (mutually exclusive with tool_id)
actionstringnoOperation id, required for builtin/mcp tool converters
preset_parametersobjectnoMerged into the tool input before invocation (tool converters only)
native_extractionstringnoFor native types (PDF/text): first (default) converts only when native extraction yields no text; skip always converts.
file_deliverystringnoHow the file reaches a tool converter (default base64)
chunk_strategystringnoDefault chunk strategy, overridable per ingest request
chunk_sizenumbernoDefault window size in characters for the size strategy
chunk_overlapnumbernoDefault overlap in characters for the size strategy
metadataanynoArbitrary JSON metadata

get-ingestion-rule​

Get an ingestion rule

Arguments​

ArgumentTypeRequiredDescription
ingestion_rule_idstringyesIngestion rule ID

update-ingestion-rule​

Update an ingestion rule

Arguments​

ArgumentTypeRequiredDescription
ingestion_rule_idstringyesIngestion rule ID
content_type_globstringnoMIME type glob matched against a file's content_type. At most 4 wildcards and 255 characters.
tool_idstring | nullno—
agent_idstring | nullno—
actionstring | nullno—
preset_parametersobject | nullno—
native_extractionstringno—
file_deliverystringno—
chunk_strategystring | nullnoSend null to clear the rule's override and fall back to the per-request default.
chunk_sizenumber | nullno—
chunk_overlapnumber | nullno—
metadataanynoA MetadataBag on a field where null is meaningful — a full-replacement update that clears the bag, or a record whose bag was never set.

delete-ingestion-rule​

Delete an ingestion rule

Arguments​

ArgumentTypeRequiredDescription
ingestion_rule_idstringyesIngestion rule ID