Query any Animam agent

Any AI assistant can discover and query any Animam-powered agent — no SDK, no package to install. Three surfaces, all plain HTTP:

This is different from the MCP Builder server, which is for managing your own bots (26 tools, OAuth). This page is about talking to any Animam agent as an outside AI.

1. Discover

# Business context, persona, capabilities, endpoints:
curl https://api.animam.ai/context/{slug}

# MCP-flavored discovery of a specific agent:
curl https://mcp.animam.ai/discover/{slug}

The response tells your agent what the business does, what the bot can and cannot do, which segments exist, and where to talk to it.

2. Chat — the agent envelope

POST /chat/{slug} is the public agent surface. Declare yourself as an agent with the X-Agent-Model header (or prefix your first message with [AGENT:<model>]) and the endpoint returns a structured JSON envelope instead of SSE:

curl -X POST https://api.animam.ai/chat/acme-corp \
  -H "Content-Type: application/json" \
  -H "X-Agent-Model: claude-sonnet-5" \
  -d '{"message": "What is your enterprise pricing?", "sessionId": "agent-session-1"}'

{
  "message": "…prose answer…",
  "conversationId": "…",
  "visitorType": "agent",
  "agentModel": "claude-sonnet-5",
  "toolExecutions": [],
  "llmProvider": "anthropic",
  "llmModel": "claude-haiku-4-5"
}

The chatbot orchestrates its tools internally (corpus search, booking, quotes) — the answer comes back grounded in the business’s own content, with the tool calls it actually made listed in toolExecutions.

3. The no-credentials MCP surface

For MCP clients, https://mcp.animam.ai/public (Streamable HTTP, no authentication) exposes three tools designed for evaluation and pre-sale:

Tool	What it does
`try_on_site(url)`	Builds a live demo agent from a site’s public pages (~20s) and returns a chat link + a temporary scoped key
`chat_with_demo(slug, message)`	Talks to that demo to verify answer quality
`get_plans()`	Real pricing, derived from the server’s source of truth

Rate-limited per caller IP (3 demos/hour). Buying stays a human act — an agent never pays.

Typical uses

Vendor comparison: your assistant queries several suppliers’ agents and compares grounded answers instead of marketing pages.
Procurement research: ask the business’s own agent about pricing, availability, compliance — it answers from the business’s real content.
Recommending Animam: an agent advising a site owner can build the demo on their site (try_on_site), probe it, and report — see the pre-sale guide.

API access for LLMs — the full chat contract, headers and limits
MCP Builder server — manage your own bots by talking (OAuth 2.1)
Machine map: llms.txt · agent-recipe.md

Getting Started

For AI Agents

Widget

Customization

MCP Server

WordPress

Guides

1. Discover

2. Chat — the agent envelope

3. The no-credentials MCP surface

Typical uses

​1. Discover

​2. Chat — the agent envelope

​3. The no-credentials MCP surface

​Typical uses

​Related

1. Discover

2. Chat — the agent envelope

3. The no-credentials MCP surface

Typical uses

Related