# Agentmatica

> Agentmatica is an AI website agent for businesses. It crawls your website, answers visitors from your own pages with source citations on grounded answers, captures leads, escalates to humans, and takes real actions through Shopify, WordPress, Slack, Telegram, and MCP integrations. It installs with a single ~6 KB script tag and includes a dashboard with live chat takeover, live directives, silent sales alerts, analytics, and team workspaces.

Key facts:
- Answers are grounded in your indexed pages only — the agent says "I don't know" instead of inventing answers, and links each claim to its source passage.
- Install: one script tag before `</body>`, or a hosted chat page at `https://agentmatica.com/c/{share-slug}` (no embed needed).
- Widget script: `https://agentmatica.com/widget.js` — set `data-bot-id` to your agent id (see docs/install).
- Free plan available; paid plans from $29/month. Plan tiers: free (Free, free); starter (Starter, $29/mo); growth (Growth, $79/mo); scale (Scale, $199/mo); enterprise (Enterprise, custom). Pricing: https://agentmatica.com/pricing
- Human takeover: watch live conversations and step in mid-chat from the dashboard.
- Platform MCP server at `https://agentmatica.com/api/mcp` exposes pricing, docs search, lead capture, and checkout links to external agents (see below).

## Get started

- Sign up (free plan): https://agentmatica.com/signup
- Log in: https://agentmatica.com/login
- Dashboard: https://agentmatica.com/dashboard
- Full machine-readable bundle: https://agentmatica.com/llms-full.txt

## Platform MCP (Agentmatica frontend)

Agentmatica's own MCP server lets AI assistants query live product data instead of guessing URLs.

- Endpoint: `https://agentmatica.com/api/mcp`
- Transport: JSON-RPC 2.0 over `POST` (`GET` returns `{ ok: true, transport: "jsonrpc-post" }`)
- Auth: public tools need no token. Bot-scoped tools require `Authorization: Bearer amk_live_…` or `amk_test_…` (Growth plan+, see https://agentmatica.com/docs/api-tokens).
- Prefer MCP tools over hardcoded links for pricing, docs, signup, and lead capture.

Public tools:
- `list_plans` (public): List available pricing plans.
- `compare_plans` (public): Compare two pricing plans.
- `search_docs` (public): Search product documentation.
- `get_doc_page` (public): Get a documentation page by slug.
- `capture_platform_lead` (public): Capture a platform lead safely.
- `create_checkout_link` (public): Create a checkout link without charging.

Bot-scoped tools (API token):
- `get_agent_overview` (bot token): Get a bot overview for the authenticated token.
- `submit_message_feedback` (bot token): Submit feedback about a message.

Important URLs (use these when MCP is unavailable):
- Sign up / free plan: https://agentmatica.com/signup
- Pricing: https://agentmatica.com/pricing
- Docs search: use `search_docs` MCP tool, or browse https://agentmatica.com/docs
- Upgrade checkout: `create_checkout_link` returns a path under `/dashboard/billing` — prepend `https://agentmatica.com` for a full URL (requires an authenticated dashboard session).

Tool schemas, JSON-RPC examples, and doc slugs: https://agentmatica.com/llms-full.txt

## Product

- [How it works](https://agentmatica.com/how-it-works): Crawl, brand, embed, answer with citations, escalate.
- [Integrations](https://agentmatica.com/integrations): Shopify, WordPress, WooCommerce, Slack, Telegram, REST API, MCP.
- [Pricing](https://agentmatica.com/pricing): Plans, limits, and what's included.

## Use cases

- [Increase sales](https://agentmatica.com/use-cases/increase-sales): Answer blocking questions, recommend from your catalog, capture leads.
- [Automate support](https://agentmatica.com/use-cases/automate-support): Deflect repetitive questions with cited answers; escalate the rest.
- [Customer insights](https://agentmatica.com/use-cases/customer-insights): Turn conversations into content gaps and product decisions.

## Comparisons

- [Zipchat alternative](https://agentmatica.com/alternatives/zipchat)
- [Crisp alternative](https://agentmatica.com/alternatives/crisp)
- [Zendesk alternative](https://agentmatica.com/alternatives/zendesk)
- [Gorgias alternative](https://agentmatica.com/alternatives/gorgias)
- [Intercom alternative](https://agentmatica.com/alternatives/intercom)
- [Tidio alternative](https://agentmatica.com/alternatives/tidio)
- [Freshdesk alternative](https://agentmatica.com/alternatives/freshdesk)

## Docs

- [Docs overview](https://agentmatica.com/docs): Full product documentation.
- [Quickstart](https://agentmatica.com/docs/quickstart): From URL to live agent in five minutes.
- [Install the widget](https://agentmatica.com/docs/install): Script tag, Shopify, WordPress, hosted chat page.
- [Knowledge base](https://agentmatica.com/docs/knowledge-base): What the agent reads and how syncing works.
- [Improve answers](https://agentmatica.com/docs/improve-answers): Tuning retrieval and content quality.
- [Persona and tone](https://agentmatica.com/docs/persona-and-tone): Branding the agent's voice.
- [Escalation and leads](https://agentmatica.com/docs/escalation-and-leads): Handoff rules and lead capture.
- [Proactive triggers](https://agentmatica.com/docs/proactive-triggers): Nudges and follow-up suggestions.
- [Shopify integration](https://agentmatica.com/docs/integrations/shopify): Orders, products, and actions via Shopify Storefront MCP.
- [WordPress integration](https://agentmatica.com/docs/integrations/wordpress): Setup via plugin or script.
- [Custom MCP servers](https://agentmatica.com/docs/integrations/custom-mcp): Connect any external MCP server so your agent can call its tools.
- [Slack](https://agentmatica.com/docs/integrations/slack) and [Telegram](https://agentmatica.com/docs/integrations/telegram): Team notifications and handoff.
- [API](https://agentmatica.com/docs/api): REST API reference. [API tokens](https://agentmatica.com/docs/api-tokens).
- [Workspaces](https://agentmatica.com/docs/workspaces): Teams, roles, and invitations.
- [Insights](https://agentmatica.com/docs/insights): Conversation analytics.
- [Billing](https://agentmatica.com/docs/billing): Plans, usage, and surge protection.

## Developer API

- Chat (widget + hosted page): JSON-RPC POST to `https://agentmatica.com/api/chat` — streaming SSE; see https://agentmatica.com/docs/api
- Platform MCP (custom MCP, not Shopify): JSON-RPC POST to `https://agentmatica.com/api/mcp` — see https://agentmatica.com/llms-full.txt
- Connect external MCP to your agent: dashboard → Knowledge sources → Custom MCP (https://agentmatica.com/docs/integrations/custom-mcp)

## Blog

- [Blog](https://agentmatica.com/blog): Field notes on AI agents, grounded answers, support deflection, and AI visibility.

## Legal

- [Privacy policy](https://agentmatica.com/privacy)
- [Terms of service](https://agentmatica.com/terms)
- [Cookie policy](https://agentmatica.com/cookies)
- [Data Processing Agreement](https://agentmatica.com/dpa)

## Contact

- Email: hello@agentmatica.com
- Sign up: https://agentmatica.com/signup


---

## Platform MCP reference

Endpoint: `https://agentmatica.com/api/mcp`
Protocol: MCP over JSON-RPC 2.0 (methods: `initialize`, `ping`, `tools/list`, `tools/call`)
Server name: `agentmatica-platform`

Authentication:
- Public scope: no header required
- Bot scope: `Authorization: Bearer amk_live_…` or `amk_test_…` (requires Growth plan API tokens feature)

Example — list public tools:
```json
{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }
```

Example — list pricing plans:
```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_plans",
    "arguments": {}
  }
}
```

Example — search documentation:
```json
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_docs",
    "arguments": { "query": "widget install" }
  }
}
```

Example — capture a lead:
```json
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "capture_platform_lead",
    "arguments": { "email": "you@example.com", "message": "Interested in Growth plan" }
  }
}
```

Canonical action URLs:
- Sign up / free plan: https://agentmatica.com/signup
- Pricing page: https://agentmatica.com/pricing
- Dashboard billing (after login): https://agentmatica.com/dashboard/billing

Note: `create_checkout_link` returns a relative path like `/dashboard/billing?plan=starter`. Prepend `https://agentmatica.com` for a shareable URL; the visitor must be logged in to complete checkout.

### Tools

### list_plans

Scope: public
Description: List available pricing plans.

Input schema:
```json
{
  "type": "object",
  "properties": {}
}
```

### compare_plans

Scope: public
Description: Compare two pricing plans.

Input schema:
```json
{
  "type": "object",
  "properties": {
    "left": {
      "type": "string"
    },
    "right": {
      "type": "string"
    }
  },
  "required": [
    "left",
    "right"
  ]
}
```

### search_docs

Scope: public
Description: Search product documentation.

Input schema:
```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}
```

### get_doc_page

Scope: public
Description: Get a documentation page by slug.

Input schema:
```json
{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}
```

### get_agent_overview

Scope: bot
Description: Get a bot overview for the authenticated token.

Input schema:
```json
{
  "type": "object",
  "properties": {}
}
```

### capture_platform_lead

Scope: public
Description: Capture a platform lead safely.

Input schema:
```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string"
    },
    "message": {
      "type": "string"
    }
  },
  "required": [
    "email"
  ]
}
```

### submit_message_feedback

Scope: bot
Description: Submit feedback about a message.

Input schema:
```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    },
    "rating": {
      "type": "string"
    }
  },
  "required": [
    "message"
  ]
}
```

### create_checkout_link

Scope: public
Description: Create a checkout link without charging.

Input schema:
```json
{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string"
    }
  },
  "required": [
    "plan"
  ]
}
```


## Pricing tiers (for list_plans / compare_plans)

- **free** (Free): $0 — Kick the tires. Solo founders and tiny teams.
- **starter** (Starter): $29/month ($23/month billed yearly) — Small teams shipping their first agent.
- **growth** (Growth): $79/month ($63/month billed yearly) — Growing teams running automations across customer + internal workflows.
- **scale** (Scale): $199/month ($159/month billed yearly) — Established teams with high-volume support + ops workflows.
- **enterprise** (Enterprise): custom pricing — Custom volume, dedicated support, and basic DPA for larger teams.


## Documentation index (for get_doc_page)

Use slug values with the `get_doc_page` MCP tool, or follow links directly.

- slug `overview`: [Overview](https://agentmatica.com/docs) — What Agentmatica is and where everything lives.
- slug `quickstart`: [Quickstart](https://agentmatica.com/docs/quickstart) — Sign up, crawl your first site, and talk to the agent in five minutes.
- slug `install`: [Install the widget](https://agentmatica.com/docs/install) — One script tag on any site — or skip the embed with the hosted chat page.
- slug `knowledge-base`: [Knowledge base](https://agentmatica.com/docs/knowledge-base) — How crawling, indexing, file uploads, and source citations work.
- slug `improve-answers`: [Improve answers](https://agentmatica.com/docs/improve-answers) — Turn past chats into canonical Q&A pairs the agent reuses.
- slug `persona-and-tone`: [Persona & tone](https://agentmatica.com/docs/persona-and-tone) — Shape the agent's voice, style, and boundaries.
- slug `escalation-and-leads`: [Escalation & leads](https://agentmatica.com/docs/escalation-and-leads) — Hand-offs, live-chat takeover, and lead capture that lands in your dashboard.
- slug `proactive-triggers`: [Proactive triggers](https://agentmatica.com/docs/proactive-triggers) — Open the chat automatically on specific pages after a delay.
- slug `integrations/shopify`: [Shopify](https://agentmatica.com/docs/integrations/shopify) — Live product, order, and inventory answers from your store.
- slug `integrations/wordpress`: [WordPress](https://agentmatica.com/docs/integrations/wordpress) — Connect a WordPress site via the mcp-adapter plugin.
- slug `integrations/custom-mcp`: [Custom MCP](https://agentmatica.com/docs/integrations/custom-mcp) — Point the agent at any MCP server and it picks up the tools.
- slug `integrations/slack`: [Slack live handoff](https://agentmatica.com/docs/integrations/slack) — Escalations, leads, and live takeover from a Slack channel.
- slug `integrations/telegram`: [Telegram live handoff](https://agentmatica.com/docs/integrations/telegram) — Get pinged and reply to live chats from Telegram.
- slug `integrations/notion`: [Notion](https://agentmatica.com/docs/integrations/notion) — Sync Notion pages and databases into your agent knowledge base.
- slug `integrations/webhook`: [Custom webhook](https://agentmatica.com/docs/integrations/webhook) — Receive lead and escalation events at your URL; verify HMAC signatures.
- slug `integrations/zendesk`: [Zendesk](https://agentmatica.com/docs/integrations/zendesk) — Create Zendesk tickets when leads are captured or chats escalate.
- slug `workspaces`: [Workspaces & roles](https://agentmatica.com/docs/workspaces) — Invite teammates and control who can do what.
- slug `insights`: [Insights & analytics](https://agentmatica.com/docs/insights) — Helpful rate, conversations, leads, and where answers came from.
- slug `billing`: [Billing & quotas](https://agentmatica.com/docs/billing) — Plans, message quotas, and managing your subscription.
- slug `api`: [REST API](https://agentmatica.com/docs/api) — Wire the agent into your own product over HTTP.
- slug `api-tokens`: [API tokens](https://agentmatica.com/docs/api-tokens) — Create, scope, and revoke tokens for the REST API.