An AI receptionist
built for AI agents.
HireJosie runs a remote MCP server and a REST API, so an assistant or agent can set up a receptionist, change routing and read calls without a human clicking through a dashboard.
7-day free trial · 200 AI min/mo · cancel anytime
The short answer
HireJosie provides a remote Model Context Protocol server at https://api.hirejosie.ai/mcp (Streamable HTTP, stateless, OAuth with dynamic client registration and PKCE) and a documented REST API. Agents can search numbers, create the receptionist, update hours, routing and FAQs, check who is reachable, test a transfer, read recent calls and fetch carrier forwarding steps. Mutating tools require sign-in and, for routing changes, an explicit confirm flag.
The MCP server
The server is at https://api.hirejosie.ai/mcp. It speaks JSON-RPC 2.0 over Streamable HTTP, is stateless and returns JSON responses. Protected-resource metadata is published at /.well-known/oauth-protected-resource, and sign-in uses OAuth with dynamic client registration and PKCE (S256). The login step is passwordless: a 6-digit code emailed to the user and entered in the same tab.
Tool arguments are validated against the same JSON Schemas as the REST API, and every tool declares whether it is read-only, destructive, idempotent or open-world so clients can decide what to ask the user before running it.
Tools
Public tools need no sign-in; the rest require an OAuth grant.
- list_industries and search_phone_numbers (public, read-only): supported business types and available US and Canadian numbers.
- setup_receptionist: creates the receptionist and provisions the number. Requires confirm=true after the user agrees.
- update_receptionist_settings: greeting, hours, closed dates, FAQs, routing destinations, forwarding and emergency contact. Routing fields require confirm=true.
- get_receptionist: current configuration, who is reachable now, closed dates and alert numbers. Read it before editing routing.
- get_recent_calls and get_morning_list: call summaries, transcripts and the emergency call-back list.
- test_transfer and test_page: place a short test call to check a destination.
- get_activation_steps: carrier call-forwarding codes for the user's existing number.
- get_calendar_link: a single-use link to connect Google Calendar.
- report_issue: sends a problem report to HireJosie.
Limits worth knowing before you build on it
Numbers and transfer destinations are US and Canada only. Setup is rate limited per email per day and globally per day, a single email can own a limited number of accounts, and public number searches are capped per hour across all callers. Healthcare and dental businesses are not set up through the app. Calls are answered by HireJosie's voice system, not by the agent that configured it.
REST API
The same functions are available over REST with an API key for automation platforms and custom agents: request access, configure, read settings, list calls and read the morning list. The LLM integration page has the endpoint reference, and /llms.txt and /llms-full.txt describe the product in a machine-readable form.
Frequently asked questions
Does HireJosie have an MCP server?
Yes: https://api.hirejosie.ai/mcp. It uses Streamable HTTP and OAuth with dynamic client registration and PKCE, and exposes tools for creating and managing an AI receptionist.
Can an AI agent change call routing through MCP?
Yes. update_receptionist_settings accepts routing destinations, business hours and closed dates. Routing changes require confirm=true, which the agent should only set after reading the new values back to the user.
Which clients can connect?
Any client that supports remote MCP servers with OAuth. The ChatGPT app is built and tested against it. Redirect hosts are restricted to a configured list (chatgpt.com, openai.com, claude.ai, claude.com by default).
How do I test it before sending real calls?
Start a trial account, connect your client, and use test_transfer to confirm a destination rings before you point real calls at the receptionist.
How much does HireJosie cost?
Starter is $29/month for 200 AI minutes and Pro is $79/month for 500 AI minutes, with $0.25 per minute after the included minutes, and a 7-day trial. No setup fees · no contracts · cancel anytime. The pricing page lists every plan and what is included.
Stop missing the calls that matter.
No setup fees · no contracts · cancel anytime.
Start 7-day free trial7-day free trial · cancel anytime