# Vanity Phone Number Studio > Spell, test, and generate memorable vanity phone numbers from words, word combos, and dev terms. > Open source, local-first, and agent-native (REST + MCP). The app turns a brief or explicit words into vanity numbers (e.g. `702-PROGRAM` = 702-776-4726), decodes numbers back into words, generates bulk combos from themed word packs, and can verify availability against Twilio's inventory. ## Install & run - [README](https://github.com/MarioGiancini/vanity-phone-number/blob/main/README.md): setup, scripts, architecture. - [Contributing](https://github.com/MarioGiancini/vanity-phone-number/blob/main/CONTRIBUTING.md): dev setup and word packs. ## Agent API - [Developers hub](/developers): all developer resources in one place. - [Agent guide](/agents.md): when to use this, which tool to call, and tips. - [Docs](/docs): human-readable API guide. - [OpenAPI](/openapi.json): OpenAPI 3.1 description (typed error schema included). - [API catalog](/.well-known/api-catalog): RFC 9727 linkset. - [Capability document](/api/agent): endpoints, themes, examples (no auth). - [auth.md](/auth.md): how agents authenticate. Endpoints: - `POST /api/agent/find` — brief or explicit words → ranked vanity numbers; optional availability. - `POST /api/agent/decode` — number → dictionary readings. - `POST /api/agent/verify` — batch-verify words against Twilio inventory. - `POST /api/availability` — single-number availability check (rate-limited). ## MCP - Remote (Streamable HTTP): `POST /api/mcp` — `Authorization: Bearer $VANITY_AGENT_API_KEY`. - [MCP server card](/.well-known/mcp/server-card): tools and transports. - [server.json](/server.json): registry manifest. - Local stdio server: `scripts/mcp-server.mjs`. ## About & trust - [About](/about) - [Privacy](/privacy): local-first, anonymous analytics with opt-out, bring-your-own carrier keys. - [Terms](/terms) - [security.txt](/.well-known/security.txt) - [Security policy](https://github.com/MarioGiancini/vanity-phone-number/blob/main/SECURITY.md) ## Optional configuration - `TWILIO_ACCOUNT_SID` + `TWILIO_AUTH_TOKEN` — enable availability checks. Without them the availability path makes zero network calls. - `VANITY_AGENT_API_KEY` — enable the `/api/agent/*` routes. ## License MIT.