Create a new document type for categorizing documents by their purpose or format (e.g., Invoice, Receipt, Contract). Can include automatic matching rules for smart classification.
AI agents use create_document_type to create or update resources in Paperless-NGX MCP Server — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Paperless-NGX MCP Server environment.
This is a Write operation: it creates new data (a document type) that can be modified or deleted later by other operations. The blast radius is low—misconfiguring a document type classification rule causes minor organizational friction but no data loss or financial impact. This is standard document management metadata creation, not destructive or executable in nature.
From the tool's definition Tool creates a new document type, adding a reversible metadata category to the system. The description explicitly states 'Create a new document type' with no mention of deletion or irreversible operations.
Documented attack patterns abuse exactly the kind of access create_document_type gives an agent:
PolicyLayer is an MCP gateway — it sits between your AI agents and Paperless-NGX MCP Server, and nothing reaches the server without passing your rules. This is the rule we recommend for create_document_type:
{
"version": "1",
"default": "deny",
"tools": {
"create_document_type": {
"limits": [
{
"counter": "create_document_type_rate",
"window": "minute",
"max": 30,
"scope": "grant"
}
]
}
}
}create_document_type stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
Free to start. No card required.
Create a new document type for categorizing documents by their purpose or format (e.g., Invoice, Receipt, Contract). Can include automatic matching rules for smart classification. It is categorised as a Write tool in the Paperless-NGX MCP Server MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
Register the Paperless-NGX MCP Server MCP server in PolicyLayer and add a rule for create_document_type: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Paperless-NGX MCP Server. Nothing to install.
create_document_type is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the create_document_type rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for create_document_type. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
create_document_type is provided by the Paperless-NGX MCP Server MCP server (nloui/paperless-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
Deterministic rules across all 16 Paperless-NGX MCP Server tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.
Free to start. No card required.
16 Paperless-NGX MCP Server tools catalogued and risk-classified — across an index of 42,500+ MCP servers.