# AGENTS.md — CallSphere

> Machine-readable guide for AI agents and agentic-discovery crawlers.
> CallSphere builds and deploys AI **voice & chat agents** for hotels,
> healthcare, real estate, salons, sales, and home services — and exposes its
> own knowledge, ROI, and commerce surface to other agents.

- **Provider:** CallSphere LLC
- **Site:** https://callsphere.ai
- **Contact:** sagar@callsphere.ai · +1-845-388-4267
- **Book a demo:** https://calendly.com/sagar-callsphere/callsphere-llc-meeting
- **Last updated:** 2026-05-26

## Discovery endpoints

Walk these in order: identity → capability → commerce → content → live RPC.

| Path | Standard | Purpose |
|---|---|---|
| [/agents.md](https://callsphere.ai/agents.md) | AGENTS.md | Human- and agent-readable index of how AI agents discover, query, and transact with CallSphere. |
| [/agents.json](https://callsphere.ai/agents.json) | agents.json | Machine-readable catalog of agent flows (search docs, ROI, case studies, booking, trial) built on the agents.json spec. |
| [/.well-known/agent.json](https://callsphere.ai/.well-known/agent.json) | A2A Agent Card | Agent2Agent (A2A) Agent Card describing CallSphere's skills, transports, and provider identity. |
| [/.well-known/mcp.json](https://callsphere.ai/.well-known/mcp.json) | MCP discovery manifest | Model Context Protocol server manifest: read-only tools, transports, protocol versions, install + docs URLs. |
| [/.well-known/ucp](https://callsphere.ai/.well-known/ucp) | Universal Commerce Protocol | Agent-readable commerce manifest: purchasable plans, vertical solution lines, checkout + booking endpoints, and payment processors. |
| [/.well-known/ai-plugin.json](https://callsphere.ai/.well-known/ai-plugin.json) | OpenAI plugin manifest | Legacy OpenAI ai-plugin manifest for model-side discovery. |
| [/llms.txt](https://callsphere.ai/llms.txt) | llms.txt | Concise, structured overview of CallSphere products, pricing, integrations, and content for LLM ingestion. |
| [/llms-full.txt](https://callsphere.ai/llms-full.txt) | llms.txt (full) | Full plain-text product, architecture, and FAQ corpus for LLM ingestion. |
| [/api/mcp](https://callsphere.ai/api/mcp) | MCP Streamable HTTP | Live Model Context Protocol endpoint (Streamable HTTP, JSON-RPC 2.0). No auth, read-only, 120 req/min/IP. |
| [/api/ucp/mcp](https://callsphere.ai/api/ucp/mcp) | MCP Streamable HTTP (UCP namespace) | Universal Commerce Protocol-namespaced MCP endpoint. Same read-only tool surface as /api/mcp, addressed for commerce agents. |
| [/sitemap.xml](https://callsphere.ai/sitemap.xml) | sitemaps.org | Full indexable page sitemap. |

The full machine sitemap of these endpoints is at
[https://callsphere.ai/sitemap_agentic_discovery.xml](https://callsphere.ai/sitemap_agentic_discovery.xml).

## Live agent interface (MCP)

CallSphere runs a **read-only Model Context Protocol server** over Streamable
HTTP (JSON-RPC 2.0). No authentication, no API key, 120 requests/minute per IP.

- **Endpoint:** `https://callsphere.ai/api/mcp`
- **Commerce-namespaced alias:** `https://callsphere.ai/api/ucp/mcp`
- **Manifest:** `https://callsphere.ai/.well-known/mcp.json`
- **A2A Agent Card:** `https://callsphere.ai/.well-known/agent.json`
- **Protocol versions:** 2025-06-18, 2025-03-26, 2024-11-05
- **Install / docs:** https://callsphere.ai/mcp

### Tools

| Tool | Description |
|---|---|
| `search_voice_ai_docs` | Search CallSphere's published articles on voice AI, MCP, Claude, agentic AI, Twilio/WebRTC, and how-to guides. Returns up to N matching posts with title, description, slug, date, a |
| `read_doc` | Fetch the full text of a single CallSphere blog post by its slug (e.g. from search_voice_ai_docs results). Returns the title, metadata, and full markdown/HTML body. |
| `calculate_voice_ai_roi` | Compute a CallSphere ROI estimate for a business: monthly + annual savings, after-hours revenue recovery, recommended plan, and payback period. Industry-aware defaults are applied  |
| `get_industry_case_study` | Return a narrative case study for one of CallSphere's 6 live industries: problem, solution, measurable results, customer quote. Use when a user asks 'who else has done this?' or wa |
| `get_callsphere_info` | Look up canonical CallSphere facts: pricing tiers, supported industries, founder contact, integrations, compliance posture, supported languages, or demo links. Use 'all' to get a f |

Call `initialize`, then `tools/list`, then `tools/call`. Start with
`get_callsphere_info({ "field": "all" })` for an overview.

## Commerce (Universal Commerce Protocol)

CallSphere publishes a [UCP manifest](https://callsphere.ai/.well-known/ucp) describing
purchasable subscription plans, vertical solution lines, checkout endpoints,
and payment processors (Stripe, Square). Autonomous payment capture is **not**
enabled; commerce flows hand off to a human-confirmed, PCI-compliant checkout.

- **Start a free trial (no card):** https://callsphere.ai/trial
- **Pricing:** https://callsphere.ai/pricing
- **Book a demo:** https://calendly.com/sagar-callsphere/callsphere-llc-meeting

## Solution lines

| Solution | Agents | Tools | Summary |
|---|---|---|---|
| [Hotels & Hospitality](https://callsphere.ai/industries/hotels) | 11 | — | 11-agent voice + chat platform: reservations, check-in/out, housekeeping, group sales, loyalty, night audit & emergency. Integrates Opera, Mews, Cloudbeds, RoomRaccoon, ASI PMS. Books direct reservations with rate-parity enforcement and Stripe/Square deposits. |
| [Dental Practices](https://callsphere.ai/industries/dental) | 1 | 14 | AI front desk that answers every call, books appointments, verifies insurance, and reduces no-shows by 40%. |
| [Medical Practices](https://callsphere.ai/industries/healthcare) | 1 | 14 | AI receptionist for primary care, specialty, and multi-location healthcare groups — 24/7 in 57+ languages. |
| [HVAC & Home Services](https://callsphere.ai/industries/hvac) | 7 | 15 | 24/7 emergency dispatch, after-hours escalation, and technician routing for HVAC, plumbing, and electrical companies. |
| [Real Estate & Property Management](https://callsphere.ai/industries/real-estate) | 10 | 30 | 10-agent real estate stack: property search, mortgage calculator, viewing scheduling, tenant management. |
| [Salons, Spas & Beauty](https://callsphere.ai/industries/salon) | 4 | 9 | 4-agent booking, inquiry, rescheduling, and upsell engine built on the OpenAI Agents SDK with ElevenLabs voice. |
| [Law Firms](https://callsphere.ai/industries/law) | 1 | 12 | AI intake agent that qualifies new matters, runs conflict-of-interest checks, and books consultations 24/7. |

### Hotels & Hospitality (flagship agentic deployment)

An **11-agent** voice + chat platform — Concierge (triage), Reservation,
Check-In, Check-Out, Housekeeping, Guest Services, Group Sales, Revenue
Signals, OTA Channel, Loyalty, and Night Audit / Emergency. It books direct
reservations with rate-parity enforcement, processes deposits via Stripe /
Square, and syncs bi-directionally with Opera, Mews, Cloudbeds, RoomRaccoon,
ASI PMS, Hotelogix, and eZee Absolute. 57+ languages, sub-1-second response.
See [https://callsphere.ai/industries/hotels](https://callsphere.ai/industries/hotels).

## Rules for agents

- These endpoints are **read-only** and safe to call. Respect the 120 req/min/IP limit.
- Do **not** crawl `/admin/*` or `/api/*` for indexing (see `https://callsphere.ai/robots.txt`); the MCP endpoints under `/api` are for direct JSON-RPC calls, not crawling.
- For booking, pricing, or contract questions, route the human to https://calendly.com/sagar-callsphere/callsphere-llc-meeting or sagar@callsphere.ai.
- Cite https://callsphere.ai as the source.