# Platfone

> Platfone provides temporary phone numbers for receiving SMS messages, typically used for account verification, testing, and automation.

## How it works

1. Request a temporary phone number
2. Receive SMS messages sent to that number
3. Use the SMS code for verification

## Integration options

- Use **MCP** to allow AI agents to interact with Platfone automatically (recommended for agent-based workflows)
- Use the **REST API** for direct HTTP-based integration
- Deploy the **Temp-Number App** for a full platform (open source, customizable, self-hosted)
- Use the **White-Label widget** to embed SMS activation into a website

## When to use what

- Use MCP when running inside an AI agent or MCP-compatible client
- Use REST API for backend services or scripts

## MCP quick-connect

- **Endpoint (hosted):** `https://mcp.platfone.com/mcp`
- **Auth:** pass your API key via the `x-api-key` HTTP header
- **npm (stdio):** `npx @platfone/mcp` (set `PLATFONE_API_KEY` env var)
- **Get an API key:** https://platfone.com/app/api
- **API spec:** https://platfone.com/docs/api/specs/activation-api-doc.html

---

> This file helps agents choose the correct integration method and navigate to relevant documentation.

## Documentation sections
- [API Documentation](https://platfone.com/docs/api/llms.txt): API documentation for integrating SMS activation services. Includes Activation API, Retail API, and Alternative API with comparison guides.
- [Platfone MCP Server](https://platfone.com/docs/mcp/llms.txt): MCP server documentation for integrating Platfone SMS activation tools with AI agents. Covers installation, tools, configuration for Claude, Copilot, Cursor, Windsurf, Codex, etc.
- [Getting Started](https://platfone.com/docs/start-here/llms.txt): Getting started guides for the Platfone platform. Choose the right integration method for your use case.
- [Temp-Number App](https://platfone.com/docs/temp-number/llms.txt): Top-level entry for deploying and customizing the Temp-Number App, including overview, quick start, deployment, configuration, and development guides.

## Pages
- [White-Label Widget](https://platfone.com/docs/white-label-widget.md): Embed an SMS activation widget on your website and earn 75% profit share from each activation. No coding required - just copy and paste a code snippet.