# CallingYou.AI

> Voice AI for local service businesses (HVAC first). A disclosed AI assistant answers the
> business phone line, confirms and books service appointments, takes structured messages
> after hours, and hands off to a human-owned channel when needed. Italy first, EU and US next.

Status: PREVIEW. The agent signup API is in preview; endpoints and shapes may change.
AI disclosure is always on: every call made or answered by CallingYou.AI identifies itself
as a virtual assistant. This is a product invariant, not a setting.

## For AI agents

- Signup runbook (two-step code, owner phone, MCP): https://callingyou.ai/agent-signup.md
- Access manifest (schema 0.3): https://callingyou.ai/.well-known/agent-access.json
- MCP endpoint (Streamable HTTP): https://api.callingyou.ai/mcp
- OAuth authorisation-server metadata: https://api.callingyou.ai/.well-known/oauth-authorization-server
- Protected-resource metadata: https://api.callingyou.ai/.well-known/oauth-protected-resource/mcp
- Server card: https://api.callingyou.ai/mcp/server-card
- AI catalog: https://callingyou.ai/.well-known/ai-catalog.json
- API catalog: https://api.callingyou.ai/.well-known/api-catalog
- API catalog on the website: https://callingyou.ai/.well-known/api-catalog

## API (preview)

Base URL: https://api.callingyou.ai

- POST /v1/agent/signup — send a code to the owner. Does not create the business yet
- POST /v1/agent/signup/{signup_id}/verify — exchange the code for an API key, shown once
- POST /v1/tenants/me/owner-phone and /verify — prove the owner's phone with the API key
- GET  /v1/me — the authenticated business (Bearer). Omits phone fields for an API key
- GET  /v1/pricing — machine-readable tiers (no amounts published during preview)
- POST /v1/billing/checkout — Stripe checkout URL (may 503 during preview)
- POST /mcp — MCP tools. subscribe_with_payment_token is listed only while STRIPE_PROFILE_ID is set
- GET  /openapi.json — OpenAPI spec for the full surface

## Humans

- Website: https://callingyou.ai
- Skills catalog (runtime tools, featured live-call skill, filterable by job): https://callingyou.ai/#skills
- Early access: hello@callingyou.ai