Temp Number MCP server for Claude, ChatGPT and your own agents

Connect once and your assistant can check prices, rent a real number and read its SMS, right inside the chat. You decide whether it may spend.

Free to connect. Pay only for the numbers you rent, from your wallet.

Works with Claude ChatGPT Cursor GitHub Copilot
3D illustration of an AI assistant connected by a cable to a smartphone showing a new SMS message

What the Temp Number MCP server does

The Model Context Protocol (MCP) is an open standard that lets AI apps use outside tools. Our server gives those apps eight phone number tools, tied to your own Temp Number account.

That means no integration work. Ask for what you need in plain words and the assistant picks the right tool, whether it is finding a country with stock, renting a number or fetching the latest SMS.

The numbers are receive-only rentals, charged at the same prices you see on the website. Need fixed, coded calls instead? Use the REST API.

https://mcp.temp-number.com/mcp
Transport
Streamable HTTP
Sign-in
OAuth 2.1 with PKCE
Headless access
MCP key (Bearer)
Tools
8 ready to use
Rate limit
90 requests per minute
Billing
Your wallet, in USD

Ask in plain words. The right tool runs.

Every tool works only on your own account. Read tools are always available; the ones marked "Needs permission" run only if you allow purchases.

"How much is left in my wallet?" get-balance Retrieve the authenticated account wallet balance and billing currency. Read only
"What does a US number cost for a month?" get-pricing Return the active pricing catalog for all countries or a single ISO country code. Read only
"Is a non-VoIP UK number in stock right now?" get-inventory Inspect live inventory availability for a country, duration, and optional number type. Read only
"Rent me a US number for one month." purchase-number Purchase one private number for the authenticated account using wallet funds. Needs permission
"Which of my numbers expire soon?" list-active-numbers Return numbers owned by the authenticated account, optionally filtered by status. Read only
"Has the code arrived on my US number yet?" check-sms Fetch SMS messages for a purchased number ID owned by the authenticated account. Read only
"Renew my UK number for another month." renew-number Renew a purchased number by ID using an optional duration package. Needs permission
"Cancel the number I just rented and refund it if eligible." cancel-number Cancel a purchased number by ID and return any eligible wallet refund. Needs permission

Connect your AI app

Pick your app. There is no key to copy in most of them: you sign in to Temp Number, choose the permissions and click Allow.

3D illustration of a blue hub with cables connecting it to several apps

Connect Temp Number to Claude

Nothing to install, and the connector follows you across the browser, desktop and mobile apps.

Add to Claude
  1. Use the button. Claude opens with our name and URL filled in, so just confirm with Add.
  2. Click Connect, log in to Temp Number, set your permissions and click Allow.
  3. In a chat, open the + menu, choose Connectors and turn on Temp Number.

Config files, MCP keys and every client option are in the developer docs.

Your assistant only gets what you allow

The sign-in screen sets the permissions for each app. Connecting does not give it spending access.

3D illustration of a shield with a padlock beside a wallet with an on and off switch

Always included

Enough to look things up on your account.

  • Wallet balance
  • Prices and live stock
  • Your numbers and when they expire
  • SMS received on your numbers

Only with "Allow purchases"

Off by default, and turning it on asks you to confirm it is really you.

  • Rent a number
  • Renew a number
  • Cancel a number and receive any eligible refund

Wallet funds only

Purchases are paid from your prepaid wallet balance, so you decide how much is available to spend.

Disconnect at any time

Every app is listed under Dashboard, MCP Server, Connected apps. One click ends its access.

Short-lived access

Sign-in tokens last one hour and renew in the background, and recovering your account revokes them.

What teams use an SMS MCP server for

It works best for your own products and accounts, under our terms of service.

Testing your own SMS flows

Have a QA agent rent a number in the target country, run your sign-up and confirm your code arrived.

Coding with real data

While building in Cursor, VS Code or Claude Code, ask for a real text to check your SMS parsing.

Number housekeeping

Ask which rentals expire this week, then renew the ones your team still needs.

Comparing countries and prices

Ask the assistant to compare stock and prices across countries before you commit to a rental.

MCP server or REST API?

Same account, same wallet and same prices. The difference is who decides which call to make.

MCP serverREST API
Best forAI apps and agentsYour own software
Who chooses the callThe assistant, from your requestYour code
Code neededNoneYes, any language
AccessSign-in or MCP keyREST API key
DocsSetup on this pageAPI documentation

Questions about the MCP server

What is an MCP server?

MCP stands for Model Context Protocol, an open standard that lets AI apps use outside tools. An MCP server publishes those tools. Ours publishes phone number tools, so a connected assistant can check prices, rent a number and read its SMS during a normal chat.

Can an AI assistant receive an SMS code?

Yes. Once connected, an assistant can read the messages on any number your account rents by calling the check-sms tool. It can only see numbers on your own account.

Which AI apps work with the Temp Number MCP server?

Claude, ChatGPT Business, Enterprise and Edu, Claude Code, Codex, Cursor and VS Code with GitHub Copilot all have setup steps on this page. Any other app that supports remote MCP servers over streamable HTTP can connect too.

Is the MCP server free to use?

Connecting is free and there is no subscription. You pay only for the numbers you rent, at the same prices as the website, from your Temp Number wallet.

Can my assistant spend money without my permission?

Not unless you allow it. Buying, renewing and cancelling need the Allow purchases option on the sign-in screen, which is off by default. With it on, the assistant can spend up to your wallet balance, so switch it on only for apps you trust and review their tool calls.

Do I need an API key?

Usually not. Apps that support sign-in only need the server URL: you log in to Temp Number and click Allow. For scripts, CI and apps without sign-in, create an MCP key in your dashboard and send it as a Bearer token. MCP keys and REST API keys are separate.

Can the numbers make calls or send texts?

No. The numbers are receive-only. They receive SMS and verification codes, but they cannot place calls or send messages.

Will a number work with every service?

No provider can promise that. Each service decides which numbers it accepts. Non-VoIP numbers are accepted more often, and an assistant can filter stock by number type before it rents one.

How do I disconnect an AI app?

Open Dashboard, then MCP Server, then Connected apps, and click Disconnect. The app loses access straight away. MCP keys can be deleted from the same page.

What is the difference between the MCP server and the REST API?

Use MCP when an AI app should choose and call the tools itself, with no code on your side. Use the REST API when your own software makes fixed calls. Both use the same account, wallet and prices.

Last updated

Connect your assistant in a minute

Top up only when you are ready to rent. See number prices by country.