# Animam.ai

> AI agent infrastructure for builders. One engine, unlimited agents — on the widget, REST API, voice, and MCP.

This file is served at <https://animam.ai/README.md> for humans and machines alike. If you are an AI agent reading this on a user's behalf, the **"For AI agents"** section below tells you exactly what you can do.

---

## For AI agents

You can interact with Animam directly — no human handoff required.

- **Read the machine map first:** <https://animam.ai/llms.txt> (short) · <https://animam.ai/llms-full.txt> (full).
- **Chat with any Animam-hosted agent over HTTP.** `POST https://api.animam.ai/chat/{slug}` with header `X-Agent-Model: <your-model>` (or prefix the first message with `[AGENT:<model>]`). You get a structured JSON envelope instead of an SSE stream:

  ```json
  {
    "message": "…",              // prose reply
    "conversationId": "…",
    "visitorType": "agent",
    "agentModel": "…",           // echo of what you declared
    "toolExecutions": [ … ],     // sanitized: name, type, success, summary, data, timestamp
    "llmModel": "claude-haiku-4-5"
  }
  ```

  The hosted agent orchestrates its own tools (corpus search, booking, payments, form bridges, recommendations) — there is no anonymous `tools/list`. **The chatbot is the agent.**

- **Connect over MCP.** `https://mcp.animam.ai` — OAuth 2.1 + PKCE, auto-discovered by Claude Desktop, claude.ai and Cursor. Tenants on Builder+ can read and configure their bots from an MCP client.

- **Configure a bot by talking (agent-native config).** If you hold a scoped token for a tenant, you can build and edit its action tools over MCP: `list_tools`, `create_tool`, `update_tool`, `delete_tool`. You emit per-type JSON config; Animam validates and applies it. Secrets never travel through the agent — secret-bearing tool types are excluded by design. Guide: <https://docs.animam.ai/guides/agent-config>.

---

## What Animam is

An API-first platform for deploying multi-tenant, multichannel, white-label AI agents. Built for agencies, dev shops and SaaS builders who run agents for many clients. Hosted in France, GDPR-compliant, powered by Claude (with BYOK for OpenAI, DeepSeek, Kimi, Mistral, Groq, Grok, Gemini, custom OpenAI-compatible and webhook providers).

One engine drives every channel — same knowledge base, persona and tools:

| Channel | Endpoint | Description |
|---|---|---|
| Widget | `cdn.animam.ai/widget.js` | Embeddable chat widget |
| REST API | `api.animam.ai/chat/{slug}` | Programmatic chat (agent-to-agent ready) |
| Voice | `api.animam.ai/voice/{slug}/chat` | Phone answering via Vapi Custom LLM (OpenAI-compatible) |
| MCP | `mcp.animam.ai` | Agent protocol, OAuth 2.1, tool config |

## Capabilities

- **Multi-tenant** — one account, N bots; parent auth, child bots, pooled conversations.
- **15 tool types** — contact forms, form prefill, computed quotes (server-side pricing), calendar booking, Stripe payments, product recommendations, visitor memory, human escalation, OTP/JWT verification, external MCP proxy, two-tier corpus exploration, verified server-to-server actions.
- **Agent-native config** — build and edit tools by talking, from Claude over MCP, the dashboard copilot, or your own bot (owner-verified). Same validated core, secrets out-of-band.
- **Conversation Digest** — a periodic email that *reads* your conversations (messages + the tools actually called) with a skeptical Claude Opus analysis: notable conversations, actions claimed without a real tool call, tool failures, unmet demands, suggestions.
- **Knowledge base (corpus)** — scraping, file import, two-tier summaries.
- **Visitor profiles** — persistent key-value memory, OTP/JWT identification.
- **WordPress plugin** — 1-click install, automatic content sync, and bridges so the agent drives the tenant's existing WPForms / WooCommerce / MailPoet.
- **Content policy** — 4 levels (SFW_STRICT → UNFILTERED), optional age gate, AI transparency banner.

## Pricing

| Plan | Price | Conversations | Bots | Key features |
|---|---|---|---|---|
| Free | 0€ | 50 | 1 | Widget, API, page context |
| Starter | 29€/mo | 500 | 1 | + Contact forms, corpus sync |
| Builder | 49€/mo | 5,000 (pooled) | 5 | + Multi-bot, MCP, tool config, stats API |
| Pro | 79€/mo | 2,000 | 1 | + Analytics, all forms |
| Agency | 199€/mo | 10,000 | unlimited | + White-label, custom domain |

## Discovery endpoints

- llms.txt — <https://animam.ai/llms.txt>
- llms-full.txt — <https://animam.ai/llms-full.txt>
- LLMFeed — <https://animam.ai/.well-known/llmfeed.json>
- A2A Agent Card — <https://animam.ai/.well-known/agent.json>
- MCP discovery — <https://animam.ai/.well-known/mcp.json>
- OAuth discovery — <https://api.animam.ai/.well-known/oauth-authorization-server>
- Docs — <https://docs.animam.ai>

## Contact

- Website — <https://animam.ai>
- Email — contact@animam.ai
- Source (WordPress plugin) — <https://github.com/animam-ai/animam.ai/tree/master/wordpress>