> ## 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 Goose

> Add Kataven to Block's open-source Goose AI agent (now Linux Foundation AAIF). Interactive CLI flow, runs anywhere Python does.

[Goose](https://goose-docs.ai/) is the open-source AI agent originally from Block, now under the Linux Foundation's Agentic AI Foundation. It runs MCP servers natively over stdio — `kataven-mcp` plugs in directly.

<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. Add Kataven via `goose configure`

Run the interactive setup:

```bash theme={null}
goose configure
```

Pick the options in this order:

1. **Add Extension**
2. **Command-line Extension** (i.e. local stdio)
3. Name: `kataven`
4. Command: `kataven-mcp`
5. Env vars: `KATAVEN_API_KEY=sk_live_acme_...`

Goose writes the result to `~/.config/goose/config.yaml`. You can edit that file directly later if needed.

## 3. Use it

Start an interactive session:

```bash theme={null}
goose session
```

Ask:

> List all my Kataven agents.

Goose picks the matching tool from its catalog and calls it.

## 4. 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

* [Goose docs](https://goose-docs.ai/) — official, including agent recipes.
* [Programmatic — agent frameworks](/sdks/mcp/programmatic) — for embedding Kataven MCP into your own agent.
* [Troubleshooting](/sdks/mcp/troubleshooting).