`hmrc_manuals`

Pack: gov-uk-content · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/hmrc_manuals for the schema, then POST the same URL with its arguments for the data.

List HM Revenue & Customs internal manuals and other UK departmental manuals — the guidance HMRC caseworkers and other officials actually apply, published in full. Covers income tax, PAYE, employment income, capital gains, corporation tax, VAT, inheritance tax, pensions, stamp duty, national insurance, trusts, residence and domicile, double taxation, compliance and penalties, plus non-HMRC manuals from other departments. Use this to see what manuals exist and their base_paths, then hmrc_manual_search to find the section that answers a question.

Parameters

Name	Type	Required	Description
`query`	string	no	Optional free text to narrow the manual list, e.g. “capital gains” or “pensions”.
`include_other_departments`	boolean	no	Also return non-HMRC departmental manuals (Home Office, DWP, and others). Default false.
`count`	number	no	Manuals per page, 1-100 (default 50).
`start`	number	no	Offset for paging.

Example call

Arguments

{
  "query": "capital gains",
  "count": 5
}

curl

curl -X POST https://gateway.pipeworx.io/gov-uk-content/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hmrc_manuals","arguments":{"query":"capital gains","count":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('hmrc_manuals', {
  "query": "capital gains",
  "count": 5
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the gov-uk-content pack

{
  "mcpServers": {
    "gov-uk-content": {
      "url": "https://gateway.pipeworx.io/gov-uk-content/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

hmrc_manuals