> ## Documentation Index
> Fetch the complete documentation index at: https://docs.willthispersonanswer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools

> Each tool is one call, one person, and returns the same answer as its endpoint. They are billed the same way.

## Tools

> [accordion] find\_mobile
>
> Finds the mobile for one profile. `check: true` adds the check. Same as [Find Mobile](https://docs.willthispersonanswer.com/api-reference/find-mobile.md). **3 credits, 5 with check.**
>
> **linkedin\_url** `string` *required*
>
> The person's LinkedIn profile URL.
>
> **first\_name** `string`
>
> Read from the profile when not given.
>
> **last\_name** `string`
>
> Read from the profile when not given.
>
> **check** `boolean` (default: false)
>
> `true` or `false`. `true` also checks the number found, for 5 credits in all.
>
> **action\_vocabulary** `string` (default: legacy)
>
> `legacy` or `priority`.
>
> **idempotency\_key** `string`
>
> Send the same value when retrying and you are charged once.

> [accordion] check\_number
>
> Says whether one number is worth calling and what to do next. Same as [Check Number](https://docs.willthispersonanswer.com/api-reference/check-number.md). **2 credits.**
>
> **first\_name** `string` *required*
>
> The contact's first name.
>
> **last\_name** `string` *required*
>
> The contact's last name.
>
> **phone** `string` *required*
>
> A phone number with its country code.
>
> **linkedin\_url** `string`
>
> Improves identity matching outside the US.
>
> **source** `string` (default: supplied)
>
> `supplied` or `enrichment`.
>
> **default\_country** `string`
>
> Two-letter country, such as `GB`, for a national number.
>
> **action\_vocabulary** `string` (default: legacy)
>
> `legacy` or `priority`.
>
> **idempotency\_key** `string`
>
> Send the same value when retrying and you are charged once.

> [accordion] list\_requests
>
> Your recent requests, newest first. Same as [List requests](https://docs.willthispersonanswer.com/api-reference/list-requests.md). **Free.**
>
> **limit** `integer` (default: 50)
>
> How many to return. 1 to 200.
>
> **kind** `string`
>
> `check_numbers`, `find_mobiles` or `csv_check`.

> [accordion] get\_request
>
> One saved request with its results. Same as [Get request](https://docs.willthispersonanswer.com/api-reference/get-request.md). **Free.**
>
> **request\_id** `string` *required*
>
> The request id returned by a check or find call.
>
> **action\_vocabulary** `string` (default: legacy)
>
> `legacy` or `priority`.

> [accordion] delete\_request
>
> Deletes a saved request and its results now. Same as [Delete request](https://docs.willthispersonanswer.com/api-reference/delete-request.md). **Free.**
>
> **request\_id** `string` *required*
>
> The request id to delete.

## What a tool returns

The same JSON as the endpoint, twice: as `structuredContent` for clients that use data, and as text for clients that only read text.

```json check_number result theme={null}
{
  "structuredContent": {
    "status": "success",
    "priority": {
      "classification": "A1",
      "label": "High priority",
      "next_action": "prioritise_calling"
    },
    "credit_cost": 2
  },
  "content": [
    { "type": "text", "text": "{ ...the same object as JSON... }" }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.