--- name: osmo-phone-calls description: Phone call AI: make phone calls with AI. AI phone call skill: use when the user wants an AI to make a real phone call for them โ€” call a business, shop, clinic, restaurant, helpline or one of their contacts; book, reschedule or cancel an appointment or reservation; reach customer service, get through the phone menu and wait on hold; call up to 5 numbers at once or schedule a call for later; bring back the answer with a summary, transcript and recording link. Also use to see who called the user's OsmO number, call them back, and run their AI receptionist. 50 free credits (US, Canada, UK, Australia) call businesses and toll-free numbers; calling contacts, call-backs and scheduling need an OsmO app plan. Not for SMS or email. version: 1.1.0 metadata: {"openclaw":{"homepage":"https://getosmo.app","emoji":"๐Ÿ“ž"}} --- # OsmO AI Phone Call OsmO's AI makes phone calls for the user and answers calls to their own number. This skill uses the hosted OsmO MCP server. There is no API key: the user signs in once with their phone number. - MCP server: `https://api.getosmo.app/mcp` (Streamable HTTP, OAuth 2.1 with PKCE and dynamic client registration) - New users get 50 free credits at https://getosmo.app/login (US, Canada, UK, Australia). With free credits, OsmO calls businesses and toll-free numbers; calling your contacts and scheduling calls need an OsmO app plan. - Terms: https://getosmo.app/terms ยท Privacy: https://getosmo.app/privacy ## Connect (once) If the `osmo` MCP tools are not available yet, tell the user to add the server and sign in. Every client below uses the same URL and the same browser sign-in. **Claude Code** ```sh claude mcp add --transport http osmo https://api.getosmo.app/mcp ``` then type `/mcp` inside Claude Code and sign in. **Codex** ```sh codex mcp add osmo --url https://api.getosmo.app/mcp codex mcp login osmo ``` **OpenClaw** ```sh openclaw mcp set osmo '{"url":"https://api.getosmo.app/mcp","transport":"streamable-http","auth":"oauth"}' openclaw mcp login osmo ``` **Hermes** (`~/.hermes/config.yaml`), then `hermes mcp login osmo`: ```yaml mcp_servers: osmo: url: "https://api.getosmo.app/mcp" auth: oauth ``` Sign-in opens `https://api.getosmo.app/mcp/oauth/connect` in the browser. The user enters their phone number and a one-time code there. Never ask for that code in chat, and never store or repeat it. ## How to use it 1. Read the tool list the server returns and use only those tools. Call `osmo_help` when unsure what OsmO can do for this account. With free credits, OsmO calls businesses (shops, clinics, restaurants, helplines) and toll-free numbers; calling the user's contacts, calling back recent callers and scheduling calls need an OsmO app plan. If a tool says something needs the OsmO app, tell the user that and do not retry. 2. **Find the number; never guess it.** - A shop, clinic, restaurant or other place: `find_business` (what and where, in plain words). It returns up to 5 Google Maps listings; `place_call` can call those numbers for 24 hours. It does not know current opening hours, so ask on the call. - A company's customer care or helpline: `find_customer_care`. Call only numbers marked `callable`; if it answers `choose`, ask the user which company they mean. - A person (OsmO app plan): `find_contact` searches the call history by name and returns a `contactId`; if nobody matches, `search_contacts` searches the phone contacts synced from the OsmO app. OsmO can call saved contacts and people who called the user in the last 30 days ("call back the person who rang this morning": `list_calls` with `callType: "inbound"`, then call that number). 3. **Before any call:** state who will be called (name and number) and exactly what OsmO will say or ask. Place the call only after the user says yes. A call reaches a real person. `place_call` without `confirmed: true` returns that preview and dials nothing; send `confirmed: true` with the same arguments only after the yes. `reason` (what OsmO says the call is for) is at most 300 characters; `context` (names, booking numbers, questions it uses without reading out) at most 700. Up to 5 numbers go in one request as `recipients`. 4. After placing a call, follow it with `get_call_status` until `resultState` is `ready`, waiting about `pollAfterSeconds` between checks, then report the outcome and summary. Do not claim something was done on the call unless the result says so. 5. **Calls for later** (OsmO app plan): pass `scheduledAt` (ISO 8601 with the user's UTC offset, at least 2 minutes ahead) to `place_call`. `list_scheduled_calls` shows calls not yet placed; `cancel_scheduled_call` calls one off (preview first, then `confirmed: true` on a yes). 6. **Past calls:** `list_calls` (10 per page, newest first; `callType` for inbound or outbound, `cursor` for older pages). `get_call` opens one call: summary, transcript and a โ–ถ Play `recordingLink`. Show the `displayTable` or `displayCard` the tool returns as it is. 7. **OsmO app chats:** `list_chats`, then `get_chat` for one chat's messages and the calls it placed. 8. **Account:** `get_account_status` gives the plan and renewal or trial end, the OsmO number and forwarding status, and calls handled; a web account gets its call credits left instead. An answered call uses 3 credits; an unanswered one is free. 9. Changes to settings or screening rules: show the change first, apply only after a yes. For the AI receptionist side (settings, rules, bookings), see the `osmo-ai-receptionist` skill. 10. If the account has no credits or no plan, say so and pass on the link the tool result gives (`openInOsmoUrl`), or https://getosmo.app/app. Do not retry. ## Boundaries - Never ask the user, or tell OsmO to ask the callee, for card numbers, bank PINs, passwords, one-time codes or government ID numbers. - No harassment, spam, robocalls or calls the callee would not expect from this user. - The skill talks only to `https://api.getosmo.app`. It runs no local code and reads no files.