# VoiceHug developer & agent resources

VoiceHug is used through the website: an organizer creates a VoiceHug, shares a link, contributors record in their browser, and VoiceHug mixes the recordings into one audio gift. AI assistants can do the organizer’s part through the VoiceHug MCP server, which signs in as the user over OAuth. There is no public REST API or SDK. This page lists everything machine-readable that VoiceHug publishes, so agents and integrators can find it at a predictable URL.

## Machine-readable resources

- [MCP server](https://www.voicehug.co/developers/mcp) — Connect an AI assistant (Meta Muse, Claude, ChatGPT…) to a VoiceHug account over OAuth to create VoiceHugs, invite contributors, and generate the final mix.
- [llms.txt](https://www.voicehug.co/llms.txt) — Site overview, positioning, and page index for language models (llmstxt.org format).
- [agents.md](https://www.voicehug.co/agents.md) — When and how AI agents should use VoiceHug on behalf of a user.
- [sitemap.xml](https://www.voicehug.co/sitemap.xml) — Every indexable page, including blog posts.
- [robots.txt](https://www.voicehug.co/robots.txt) — Crawl rules; all public pages are open to well-behaved crawlers.
- [JSON-LD](https://www.voicehug.co/) — Organization, WebSite, and SoftwareApplication schema.org data embedded in every page.

## Markdown versions of pages

Request any of /, /faq, /developers, /developers/mcp, /partners, /contact, /blog, /blog/<slug> with `Accept: text/markdown`
to receive markdown instead of HTML (responses carry `Vary: Accept`), or use
the explicit URLs:

- [Homepage](https://www.voicehug.co/md) — What VoiceHug is and how it works.
- [FAQ](https://www.voicehug.co/md/faq) — Pricing, limits, privacy, and delivery.
- [Developers](https://www.voicehug.co/md/developers) — This page.
- [MCP server docs](https://www.voicehug.co/md/developers/mcp) — Endpoint, OAuth, and tool reference for the MCP server.
- [Partners](https://www.voicehug.co/md/partners) — Affiliate and partner program.
- [Contact](https://www.voicehug.co/md/contact) — How to reach the team.
- [Blog index](https://www.voicehug.co/md/blog) — All posts; each post is at /blog/<slug>/md.

## 404 convention

Nonexistent paths return a real HTTP 404. Browsers get an HTML page; any client that does not explicitly accept text/html (curl, fetch defaults, most agents) gets a short text/markdown body with links to the sitemap, llms.txt, and agents.md. Unknown paths under /api/ instead return a JSON 404 body with error, code, message, and hint fields; apart from the MCP server at /api/mcp, those routes serve the VoiceHug web app and are not a public API.

## Contact

Partnership, affiliate, and integration inquiries (including requests for API access) are welcome by email. Email: hello@voicehug.co