# govuk

MCP server for GOV.UK — search, content drill-down, organisations, and postcode lookup.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add bouch/govuk

# Browse available tools
npx -y smithery tool list bouch/govuk

# Get full schema for a tool
npx -y smithery tool get bouch/govuk govuk_search

# Call a tool
npx -y smithery tool call bouch/govuk govuk_search '{}'
```

## Direct MCP Connection

Endpoint: `https://govuk--bouch.run.tools`

## Tools (7)

- `govuk_search` — Search GOV.UK's 700k+ content items using the official Search API.
- `govuk_grep_content` — Find body sections in a GOV.UK content item matching a pattern.
- `govuk_list_organisations` — List all UK government organisations registered on GOV.UK.
- `govuk_lookup_postcode` — Look up a UK postcode to retrieve its local authority, region, constituency,
- `govuk_get_content` — Get metadata and navigable section index for a GOV.UK page.
- `govuk_get_section` — Get the HTML content of one named section of a GOV.UK page.
- `govuk_get_organisation` — Get the profile of a UK government organisation by its slug.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get bouch/govuk <tool-name>
```