Get Companies House Filing Document
company_filing_documentConvert a filing's document_metadata URL into a direct company-document resource link, enabling PDF retrieval via resources/read. Provides metadata (category, pages, size) without downloading the file.
Instructions
Resolve a filing's document_metadata link to its authoritative source document.
Returns a resource_link (never embedded bytes, never base64) pointing at a company-document:// MCP resource — fetch it via resources/read to get the actual PDF. This tool only reads metadata (category, pages, available content types, byte size); it never downloads the document itself. Use company_filing_history first to find a filing's document_metadata URL.
Requires a resource-capable MCP client to retrieve the actual bytes — a tool-only client can see this result's metadata (company, category, page count, size) but cannot obtain the file through this tool call alone.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mime_type | No | Which content representation to select, e.g. 'application/pdf'. Omit when the document has only one representation (the near-universal case) — it is auto-selected. Required if the document has more than one; omitting it in that case returns a validation error listing the choices. | |
| document_metadata_url | Yes | The document_metadata URL from a filing's links.document_metadata (returned by company_filing_history) — pass it through verbatim, not a document_id. Must be an exact https://document-api.company-information.service.gov.uk/document/{id} URL. |