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.
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
get-inventory checked US stockpurchase-number paid from walletcheck-sms 1 new message- 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.
get-balance
Retrieve the authenticated account wallet balance and billing currency.
Read only
get-pricing
Return the active pricing catalog for all countries or a single ISO country code.
Read only
get-inventory
Inspect live inventory availability for a country, duration, and optional number type.
Read only
purchase-number
Purchase one private number for the authenticated account using wallet funds.
Needs permission
list-active-numbers
Return numbers owned by the authenticated account, optionally filtered by status.
Read only
check-sms
Fetch SMS messages for a purchased number ID owned by the authenticated account.
Read only
renew-number
Renew a purchased number by ID using an optional duration package.
Needs permission
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.
Connect Temp Number to Claude
Nothing to install, and the connector follows you across the browser, desktop and mobile apps.
Add to Claude- Use the button. Claude opens with our name and URL filled in, so just confirm with Add.
- Click Connect, log in to Temp Number, set your permissions and click Allow.
- In a chat, open the + menu, choose Connectors and turn on Temp Number.
Connect Temp Number to ChatGPT
Available on ChatGPT Business, Enterprise and Edu on the web. On Business, an admin or owner adds it. ChatGPT has no pre-filled link, so copy the URL first.
https://mcp.temp-number.com/mcp- On the Plugins page, click + and then Add custom MCP server.
- Name it Temp Number, paste the URL under Connection and set authentication to OAuth.
- Accept the warning, click Create as a plugin, sign in and click Allow.
- In a new chat, type @ and choose Temp Number.
Connect Temp Number to Claude Code
Run this once in your terminal.
claude mcp add --transport http temp-number https://mcp.temp-number.com/mcp- Start Claude Code and type
/mcp. - Choose temp-number, then Authenticate. Sign in when your browser opens and click Allow.
Connect Temp Number to Codex CLI
Add the server, then sign in. Codex keeps the session for you.
codex mcp add temp-number --url https://mcp.temp-number.com/mcp
codex mcp login temp-numberConnect Temp Number to Cursor
One click installs the server. Cursor then shows "Needs login" beside it: click that, sign in and click Allow.
Add to CursorConnect Temp Number to VS Code
One click adds the server for GitHub Copilot. You sign in the first time a tool runs.
Add to VS CodeConnect any other MCP app
Add this URL as a remote streamable HTTP server. Apps with sign-in support find our login screen on their own. Others can send an MCP key from your dashboard as Authorization: Bearer <key>.
https://mcp.temp-number.com/mcpConfig files, MCP keys and every client option are in the developer docs.
Product names and logos belong to their owners and are shown only to explain compatibility. Temp Number is not affiliated with or endorsed by them.
Your assistant only gets what you allow
The sign-in screen sets the permissions for each app. Connecting does not give it spending access.
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 server | REST API | |
|---|---|---|
| Best for | AI apps and agents | Your own software |
| Who chooses the call | The assistant, from your request | Your code |
| Code needed | None | Yes, any language |
| Access | Sign-in or MCP key | REST API key |
| Docs | Setup on this page | API 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.