> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kataven.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Kataven MCP to Raycast AI

> Add Kataven to Raycast AI on macOS. @-mention Kataven from any AI Chat or Quick AI prompt.

Raycast supports MCP via its [Model Context Protocol extension](https://www.raycast.com/EvanZhouDev/mcp). Once installed, you @-mention Kataven from any AI Chat or Quick AI prompt.

<Note>
  Already done [Install](/sdks/mcp/install)? Skip to step 2.
</Note>

## 1. Mint an API key + install the binary

`pip install kataven-mcp`, then mint a key at [hub.kataven.ai/settings](https://hub.kataven.ai/settings) → **API Keys** tab. Full walkthrough: [Install](/sdks/mcp/install).

## 2. Install the MCP extension

In Raycast, search **`Store`** → find **Model Context Protocol** (by EvanZhouDev) → **Install**. Direct link: [raycast.com/EvanZhouDev/mcp](https://www.raycast.com/EvanZhouDev/mcp).

## 3. Add Kataven

After install:

1. Raycast → search **`Manage MCP Servers`** → press Enter.
2. **+ Add Server**.
3. **Server Type:** Stdio.
4. **Command:** `kataven-mcp`.
5. **Env:** `KATAVEN_API_KEY=sk_live_acme_...`.
6. Save.

## 4. Use it

In any AI prompt — root search, AI Chat, AI Commands, Presets — type **`@kataven`** to give the model access to Kataven tools. Then ask:

> @kataven list all my agents

The model picks `kataven_list_agents` from the @-mentioned server's tool list.

## 5. Verify in the dashboard

| What changed         | Open in Hub UI                                                       |
| -------------------- | -------------------------------------------------------------------- |
| Agents               | [hub.kataven.ai/agents](https://hub.kataven.ai/agents)               |
| Phone numbers        | [hub.kataven.ai/phone-numbers](https://hub.kataven.ai/phone-numbers) |
| Live or recent calls | [hub.kataven.ai/conversations](https://hub.kataven.ai/conversations) |
| Campaigns            | [hub.kataven.ai/campaigns](https://hub.kataven.ai/campaigns)         |

## See also

* [Raycast Manual — Model Context Protocol](https://manual.raycast.com/model-context-protocol).
* [Troubleshooting](/sdks/mcp/troubleshooting).