---
title: "Return a public-record success story"
method: POST
path: "/tools/random_success_story"
---

# Return a public-record success story

`POST /tools/random_success_story`

## Request

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

Returns one public-record UK Global Talent Visa success story (name, role, route, endorsement year, paraphrased bio) sourced from Tech Nation's published profiles.

## Request body

- object

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