Screen UK numbers against TPS and CTPS, wash AU numbers against the DNCR, check dead mobiles.
uk.co.tpsclear/tpsclear — Model Context Protocol (MCP) Server
The uk.co.tpsclear/tpsclear MCP server provides functionality to screen UK numbers against TPS and CTPS, wash AU numbers against the DNCR, and check dead mobiles. It exposes these capabilities as tools for integration via MCP.
🛠️ Key Features
Screen UK numbers against TPS and CTPS
Wash AU numbers against DNCR
Check dead mobile numbers
🚀 Use Cases
Verify whether UK numbers are listed with TPS/CTPS
Clean AU datasets using DNCR washing
Identify and remove dead mobile numbers
⚡ Developer Benefits
Focused, number-checking workflows for telecom-related data
Direct mapping of screening/washing/check tasks to MCP tooling
⚠️ Limitations
Available scope is limited to TPS/CTPS screening, DNCR washing, and dead mobile checks based on provided description
Captured live from the server via tools/list.
screen_numbers
Screen UK phone numbers against the TPS and CTPS registers before calling. Each result is clean, tps-listed, ctps-listed, unknown, suppressed or consented. Draws the account's prepaid UK credits, one per distinct valid number; a test API key (tpsc_test_) returns fixtures at no cost. Same as POST /v1/screen.
Parameters2
phone_numbers
array
required
Phone numbers, up to 1,000 per call, for example "+447700900123".
campaign_ref
string
optional
Optional reference stored on the audit record: letters, digits, spaces and . , : / # _ - only.
Raw schema
{
"type": "object",
"properties": {
"phone_numbers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"minItems": 1,
"maxItems": 1000,
"description": "Phone numbers, up to 1,000 per call, for example \"+447700900123\"."
},
"campaign_ref": {
"type": "string",
"maxLength": 120,
"description": "Optional reference stored on the audit record: letters, digits, spaces and . , : / # _ - only."
}
},
"required": [
"phone_numbers"
],
"additionalProperties": false
}
wash_au_numbers
Wash Australian phone numbers against the Do Not Call Register. Needs a live account (an OAuth sign-in or a tpsc_live_ key), as the register has no test mode. One prepaid AU wash per distinct valid number; invalid numbers cost nothing and numbers the register gave no answer for are refunded. Same as POST /v1/dncr.
Parameters1
phone_numbers
array
required
Phone numbers, up to 500 per call, for example "+61412345678".
Raw schema
{
"type": "object",
"properties": {
"phone_numbers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"minItems": 1,
"maxItems": 500,
"description": "Phone numbers, up to 500 per call, for example \"+61412345678\"."
}
},
"required": [
"phone_numbers"
],
"additionalProperties": false
}
check_dead_numbers
Live mobile network (HLR) lookups: whether each mobile is live, switched off or dead. Needs a live account (an OAuth sign-in or a tpsc_live_ key). One prepaid dead number check per mobile, two for a US number; numbers that are not mobiles and invalid numbers cost nothing. Same as POST /v1/dead-number.
Parameters1
phone_numbers
array
required
Phone numbers, up to 500 per call, for example "+447700900123".
Raw schema
{
"type": "object",
"properties": {
"phone_numbers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"minItems": 1,
"maxItems": 500,
"description": "Phone numbers, up to 500 per call, for example \"+447700900123\"."
}
},
"required": [
"phone_numbers"
],
"additionalProperties": false
}
get_account
The connected account and the key it acts as: environment, scopes, company name and whether one is still required (GET /v1/me), plus the UK credits left (GET /v1/usage), the Australian washes left (GET /v1/dncr) and the dead number checks left (GET /v1/dead-number). A balance the key lacks the scope for comes back as that error. Costs nothing.
Set the legal name of the business this account screens numbers for (PATCH /v1/me). Required before a live key can screen. Voll Studios Ltd, the company behind TPSClear, is licensed by the DMA as a TPS and CTPS list cleaner. The licence requires a monthly declaration naming each client, so a live API key must belong to an account that names the business it screens numbers for.
Parameters1
company_name
string
required
The legal name of the client business, for example "Acme Outbound Ltd".
Raw schema
{
"type": "object",
"properties": {
"company_name": {
"type": "string",
"minLength": 2,
"maxLength": 160,
"description": "The legal name of the client business, for example \"Acme Outbound Ltd\"."
}
},
"required": [
"company_name"
],
"additionalProperties": false
}
buy_credits
Creates a Stripe Checkout payment link for a prepaid pack on the connected account and returns the URL. Nothing is charged by this tool: a person opens the link and pays by card, and the credits land on the account once paid. Needs a live, self-serve account that names its client business. Prices are in minor units in the response. Packs: pack-1k: TPSClear UK API credits (1,000 checks), £9.00 ex VAT; pack-5k: TPSClear UK API credits (5,000 checks), £24.00 ex VAT; pack-10k: TPSClear UK API credits (10,000 checks), £39.00 ex VAT; pack-50k: TPSClear UK API credits (50,000 checks), £149.00 ex VAT; pack-100k: TPSClear UK API credits (100,000 checks), £199.00 ex VAT; pack-500k: TPSClear UK API credits (500,000 checks), £599.00 ex VAT; pack-1m: TPSClear UK API credits (1,000,000 checks), £799.00 ex VAT; pack-5m: TPSClear UK API credits (5,000,000 checks), £2499.00 ex VAT; au_100: TPSClear Australian DNCR washes (100), A$4.00 ex VAT; au_250: TPSClear Australian DNCR washes (250), A$9.00 ex VAT; au_500: TPSClear Australian DNCR washes (500), A$14.00 ex VAT; au_1000: TPSClear Australian DNCR washes (1,000), A$24.00 ex VAT; au_2500: TPSClear Australian DNCR washes (2,500), A$48.00 ex VAT; au_5000: TPSClear Australian DNCR washes (5,000), A$85.00 ex VAT; au_10000: TPSClear Australian DNCR washes (10,000), A$145.00 ex VAT; au_25000: TPSClear Australian DNCR washes (25,000), A$310.00 ex VAT; au_50000: TPSClear Australian DNCR washes (50,000), A$600.00 ex VAT; au_100000: TPSClear Australian DNCR washes (100,000), A$1170.00 ex VAT; dn_100: TPSClear dead number checks (100), £1.00 ex VAT; dn_250: TPSClear dead number checks (250), £2.50 ex VAT; dn_500: TPSClear dead number checks (500), £5.00 ex VAT.
Every prepaid pack on sale: its id (the one buy_credits takes), name, what it buys, price in minor units ex VAT, currency and how many months the credits last. Optionally filter by kind. Costs nothing.
Parameters1
kind
string
optional
Optional. uk_credits for UK TPS and CTPS checks, au_washes for Australian Do Not Call Register washes, dead_number_checks for live mobile (HLR) checks.
Raw schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"uk_credits",
"au_washes",
"dead_number_checks"
],
"description": "Optional. uk_credits for UK TPS and CTPS checks, au_washes for Australian Do Not Call Register washes, dead_number_checks for live mobile (HLR) checks."
}
},
"additionalProperties": false
}
get_screening_history
The account's recent activity, newest first: each UK screening call (time, environment, numbers checked, counts by outcome, campaign_ref, request_id) and each movement on the UK credit, AU wash and dead number balances (purchases, draws, refunds). Phone numbers are never returned. Page back by passing next_before as before. Needs the usage scope. Costs nothing.
Parameters2
limit
integer
optional
How many events to return, 20 by default and up to 100.
before
string
optional
Optional ISO 8601 timestamp with a time zone, for example "2026-11-02T09:30:00Z". Only events before it are returned. Pass next_before from the previous page.
Raw schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "How many events to return, 20 by default and up to 100."
},
"before": {
"type": "string",
"maxLength": 40,
"description": "Optional ISO 8601 timestamp with a time zone, for example \"2026-11-02T09:30:00Z\". Only events before it are returned. Pass next_before from the previous page."
}
},
"additionalProperties": false
}