`hmrc_manual_search`

Pack: gov-uk-content · Endpoint: https://gateway.pipeworx.io/gov-uk-content/mcp

Find the section of an HMRC internal manual that answers a UK tax question asked in plain words — salary sacrifice, benefits in kind, travel and subsistence expenses, termination payments, share schemes, residence and domicile, capital gains reliefs, VAT liability, IR35 and off-payroll working, pension annual allowance, inheritance tax reliefs, penalties and compliance. This is HMRC’s own working interpretation of the UK tax code, section by section, and it is the level at which UK tax questions are actually answered. Returns each matching section with its manual, its section id (EIM42750, CG12345 and the like), its URL, its published_at date and age_days. Narrow to one manual with the manual argument. Retrieve the full text of a hit with hmrc_manual_section.

Parameters

Name	Type	Required	Description
`query`	string	yes	The tax question or topic in plain words, e.g. “salary sacrifice pension contributions” or “when is travel to a temporary workplace deductible”.
`manual`	string	no	Restrict to one manual, as a base_path or slug, e.g. “/hmrc-internal-manuals/employment-income-manual” or “employment-income-manual”. Get these from hmrc_manuals.
`include_other_departments`	boolean	no	Also search non-HMRC departmental manual sections. Default false.
`count`	number	no	Sections to return, 1-100 (default 20).
`start`	number	no	Offset for paging.

Example call

Arguments

{
  "query": "salary sacrifice pension contributions",
  "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_manual_search","arguments":{"query":"salary sacrifice pension contributions","count":5}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('hmrc_manual_search', {
  "query": "salary sacrifice pension contributions",
  "count": 5
});

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

hmrc_manual_search