--- title: "Quickstart" description: "Add CallForMe to your AI agent with one URL, click Connect once, try the free demo line, and place your first real phone call to a business in two minutes." url: https://callforme.tel/docs/quickstart updated: 2026-09-29 --- # Quickstart > Add the MCP server https://callforme.tel/mcp to your agent and click Connect when it asks. A tab opens and closes by itself, with no form or card. Try the free demo line first. On your first real call your agent shows one link to add $10, and after that every session just calls. ## 1. Add the server ### Claude Code From your terminal: ``` claude mcp add --transport http callforme https://callforme.tel/mcp ``` ### Any other MCP agent Add a remote MCP server (streamable HTTP) with this URL: ``` https://callforme.tel/mcp ``` Exact steps for each agent, including Claude Desktop, claude.ai, ChatGPT, Codex, Cursor, VS Code, Gemini CLI and more, are on the [agents page](/agents). ### No MCP? Use the skill and curl If your agent can run shell commands, tell it: > Read https://callforme.tel/skill.md and use it to call businesses for me. The skill walks it through the [REST API](/docs/rest-api) with curl. See [any agent with a shell](/agents/any-agent). ## 2. Connect once After you add the URL, your agent shows a Connect or Authenticate step: - **claude.ai and Claude Desktop:** click Connect on the connector. - **Claude Code:** run `/mcp`, pick `callforme`, choose Authenticate. - **Codex:** run `codex mcp login callforme`. - **Others:** a Connect, Login or Authenticate button or prompt appears after you add the server. A browser tab opens and closes by itself. No email, no form, no card. That creates your CallForMe account. ## 3. Try it free first Before calling a real business, ask for a practice call: > Call Maple Street Pizza at (469) 770-7412 and ask if they have a gluten-free crust and how long a large pepperoni takes for pickup. Maple Street Pizza is a fictional restaurant run by CallForMe. Calls to it are free and need no payment, up to 5 a day. You'll see the whole flow: the call, a question or two mid-call, and the result. ## 4. Ask for a real call Say what you want in plain words: > Call the CVS on Preston Road and ask if they're open on Thanksgiving and until what time. Your agent will usually: 1. Use `find_business` to get the phone number and today's hours. 2. Use `plan_call` to preview the opening line, a checklist, and questions the business might ask. 3. Use `place_call` to start the call. ## 5. One setup link, the first time The first real call returns: ```json { "status": "needs_setup", "setup_url": "https://callforme.tel/go/k7m2q", "setup_code": "k7m2q", "message_for_user": "To place this call, open https://callforme.tel/go/k7m2q and add $10. Then tell me when you're done." } ``` Your agent shows you the link. The page shows the exact call it's about to place. Add $10 (your card is saved and auto-reloads), or claim creator credit with your email. The page says "Done, go back to your agent." Tell your agent you're done. It calls `place_call` again with the `setup_code`, and the phone rings. That's the last setup step: every chat and session after this just calls. Adding CallForMe to a second agent later? Its first call link recognizes you and links it to your account in one click, no second payment. More in [how setup links work](/docs/setup-links). ## 6. Get the result Your agent polls `get_call` with `wait_seconds` up to 50 until `status` is `ended`. If the business asks something your agent doesn't know, `pending_question` shows up and your agent replies with `answer_question`. The final result includes the transcript, your answers, and an outcome: ```json { "status": "ended", "answers": { "Are you open on Thanksgiving?": "Yes, 9am to 5pm. Pharmacy counter 10am to 2pm." }, "outcome": { "success": true, "summary": "Store open Thanksgiving 9 to 5, pharmacy 10 to 2.", "next_steps": "None." }, "duration_s": 74, "cost_usd": 1.00 } ``` Want to show someone? Ask your agent to share the call. `share_call` makes a public page at `https://callforme.tel/c/` with phone numbers and emails hidden. ## If your client can't connect Some clients don't support MCP sign-in. Use `https://callforme.tel/mcp/open` (no sign-in; your agent gets a setup link in each new session unless it saves the `account_key` it receives), or create a key on the [account page](https://callforme.tel/account) and use `https://callforme.tel/mcp/k/` or the header `Authorization: Bearer cfm_...`. Details in the [MCP reference](/docs/mcp). ## Next - [Use cases](/use-cases) for ideas and example prompts - [MCP reference](/docs/mcp) for every tool and field - [Pricing](/docs/pricing) ## FAQ ### Do I have to sign up before connecting? No form. When you add the URL, your agent shows a Connect or Authenticate step. A browser tab opens and closes by itself, and that creates your account. No email and no card at that point. ### Can I try it without paying? Yes. Ask your agent to call Maple Street Pizza, a fictional restaurant, at (469) 770-7412. Demo calls are free and need no payment, up to 5 a day. ### My agent isn't listed. Can I still use it? If it supports remote MCP servers, use https://callforme.tel/mcp. If it can run shell commands, point it at https://callforme.tel/skill.md and it will use the REST API with curl. ### What does the first real call cost? $1 if answered, covering the first 5 minutes, then $0.25 per minute. You add $10 to start, the card is saved for auto-reload, and the balance never expires.