# Mavra

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-dinastia-uk-mavra-mcp-skill-mavra`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [DinastIA-UK](https://agentstack.voostack.com/s/dinastia-uk)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [DinastIA-UK](https://github.com/DinastIA-UK)
- **Source:** https://github.com/DinastIA-UK/mavra-mcp-skill/tree/main/skills/mavra

## Install

```sh
agentstack add skill-dinastia-uk-mavra-mcp-skill-mavra
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Managing Mavra via MCP

Mavra is a CRM + AI-agent platform. This skill lets you manage a Mavra account by
chatting with your AI client, through the Mavra MCP server.

## 1. Connect (once)

Register the Mavra MCP server in this client by running the bundled script with Node
(works on macOS, Windows, and Linux):

```bash
node "${CLAUDE_SKILL_DIR}/scripts/connect.mjs"        # production
node "${CLAUDE_SKILL_DIR}/scripts/connect.mjs" --dev  # development
```

`${CLAUDE_SKILL_DIR}` is set by Claude Code. In other clients, run the
`scripts/connect.mjs` file from this skill's folder with `node`, or add a remote (HTTP)
MCP server pointing at `https://api.maiacompany.io/mcp` (or
`https://dev.api.maiacompany.io/mcp`).

## 2. Log in

Call the **`login`** tool with the user's email and password. It returns several
tokens. **Use the `idToken` (NOT the accessToken) as the `authToken` argument on every
other tool call.**

If any tool returns a 401, call **`refresh`** with the `refreshToken` to get a new
`idToken`, then retry.

## 3. Recipes

Each recipe shows the exact arguments to pass. Replace `IDTOKEN` with the `idToken` from
`login`. For the full list of tools, actions, typed request fields, and response shapes,
read `references/tools.md`.

### Create an AI agent

```json
{ "action": "create", "authToken": "IDTOKEN",
  "title": "Sales Assistant",
  "customPrompt": "You are a helpful sales assistant.",
  "contextSize": 4000 }
```

Call `manage_agents` with the above. **`contextSize` must be between 800 and 128000.**
The response includes the new agent's `id` (use it for `get` / `update` / `delete`). To
turn on guardrails later, call `manage_agents` `action: "update"` with `agentId` plus
`guardrailsEnabled: true`.

**Important — the `customPrompt` has a special syntax.** It is NOT just plain text: Mavra
parses `@`-decorators and `{{variables}}` for flows, tool calls, CRM writes, transfers,
follow-ups, and media. To write effective agents, read **`references/prompt-syntax.md`**.
Quick taste:

```
@IF customer asks about pricing [price, cost]
@THEN @Tool(SendPricingGuide)
@ELSE Continue qualifying the lead.
@END
@updateCRM("Sales Pipeline", "status", "Mark 'Qualified' when budget is confirmed")
```

### Add and find a CRM record

Create with `manage_crm_records` `action: "create"` (`title` required):

```json
{ "action": "create", "authToken": "IDTOKEN", "title": "Acme Corp" }
```

The response returns **`recordId`** — use it for later `get` / `update` / `delete`. To
search, call `search_crm` `action: "search"` with `q: "acme"`.

### List sessions and transfer one

`manage_sessions` `action: "list"` returns `{ items: [...] }`. To move a conversation to
another agent:

```json
{ "action": "transfer", "authToken": "IDTOKEN",
  "channelId": "CHANNEL_ID", "sessionId": "SESSION_ID",
  "targetAgentId": "AGENT_ID" }
```

### Configure a webhook

`manage_webhooks` `action: "create"` with `name`, `url`, and `triggerTypes` (a string
array):

```json
{ "action": "create", "authToken": "IDTOKEN",
  "name": "CRM events", "url": "https://example.com/hook",
  "triggerTypes": ["crm_record_created"] }
```

### Channels & WhatsApp

Create/edit channels with `manage_channels` (requires `name`, `type`, `identifier`,
`defaultAgentId`). Full WhatsApp (Meta Cloud API) setup is also supported: create a
connection with `manage_connections`, the channel with `manage_channels`, then link them
with `manage_whatsapp` `action: "setup"`. See `references/channels.md` for the
step-by-step flow.

## 4. When something goes wrong

- **401** — the token expired: call `refresh`, then retry with the new `idToken`.
- **403** — the logged-in user's role can't perform this action.
- **429** — rate limited: wait the number of seconds in the error message, then retry.
- **Validation errors** — the message names the missing/invalid field; fix and retry.

## Reference

Read these on demand for complete, typed detail:

- **`references/tools.md`** — every tool, action, typed request field, and response shape.
- **`references/prompt-syntax.md`** — the agent `customPrompt` `@`-decorator + `{{variable}}` language (essential for writing agents).
- **`references/agents.md`** — all agent fields, providers/models, guardrails, knowledge base, media, versioning, testing, feedback.
- **`references/crm.md`** — CRM records, custom field types, field groups, statuses, kanbans, filters, search.
- **`references/channels.md`** — channel types, contacts, and the WhatsApp connection setup flow (`manage_connections` + `manage_whatsapp`).
- **`references/chat-and-settings.md`** — sessions, messages (send vs send-as-agent vs human reply), chat notes, provider keys, webhooks + event types.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [DinastIA-UK](https://github.com/DinastIA-UK)
- **Source:** [DinastIA-UK/mavra-mcp-skill](https://github.com/DinastIA-UK/mavra-mcp-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dinastia-uk-mavra-mcp-skill-mavra
- Seller: https://agentstack.voostack.com/s/dinastia-uk
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.