---
title: "Return the canonical apply URL"
method: POST
path: "/tools/apply_now_url"
---

# Return the canonical apply URL

`POST /tools/apply_now_url`

## Request

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

Returns the canonical URL to begin a UK Global Talent Visa draft, optionally tagged with a referral source. Use as the start-draft CTA after an agent has helped a user evaluate their profile.

## Request body

- object
  - `referral` string: Optional source/referral tag (e.g. "chatgpt", "perplexity", or a campaign name). Letters, digits, hyphen, underscore only; truncated to 64 chars.

## 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)