---
title: "Search the Global Talent Handbook"
method: POST
path: "/tools/search_handbook"
---

# Search the Global Talent Handbook

`POST /tools/search_handbook`

## Request

- Base URL: `https://ukglobaltalentvisa.org/mcp/rest`
- URL: `https://ukglobaltalentvisa.org/mcp/rest/tools/search_handbook`
- Auth: none required

Full-text search across the five-chapter Global Talent Handbook. Returns the most relevant chapter passages with links back to ukglobaltalentvisa.org/faq.

## Request body

- object
  - `query` string, required: Natural-language question about the visa.
  - `limit` integer: Maximum number of passages to return.

## Response `200`

Markdown-formatted tool result, flattened from the MCP `content` array.

- ToolResult
  - `text` string, required: Markdown body — pass straight through to the user.
  - `isError` boolean: True when the backend returned a recoverable tool error (e.g. unknown route_slug). The status code stays 200 so ChatGPT can still surface the message to the user.

## Other responses

- `400`: Tool error.
- `502`: Tool error.

---

[API](https://skmtc.dev/ukglobaltalentvisa/apis/uk-global-talent-visa-mcp-rest-surface.md) · [All operations](https://skmtc.dev/ukglobaltalentvisa/apis/uk-global-talent-visa-mcp-rest-surface/llms.txt) · [OpenAPI document](https://skmtc.dev/ukglobaltalentvisa/apis/uk-global-talent-visa-mcp-rest-surface/revisions/a835b935f109?raw)