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

# Overview

> Connect your Tanvik workspace to Claude with the Tanvik MCP server

The **Tanvik MCP server** lets you connect your Tanvik workspace to [Claude](https://claude.ai) (and other MCP-compatible AI clients) so you can ask questions about your leads, contacts, conversations, orders, and campaigns — and take actions like sending a WhatsApp message — directly from a chat, in plain language.

MCP ([Model Context Protocol](https://modelcontextprotocol.io)) is an open standard for connecting AI assistants to external tools and data. Tanvik ships an MCP server that exposes your workspace's data and actions as tools Claude can call on your behalf.

## What you can do

Once connected, you can ask Claude things like:

* "How many new leads came in this week, and which are still unassigned?"
* "Show me the last conversation with +919876543210."
* "What's my wallet balance and recent transactions?"
* "List my open support tickets."
* "Send a WhatsApp message to this customer letting them know their order shipped."

Claude reads the relevant data through the MCP server and responds — and, for actions you've explicitly enabled, carries them out.

## Scoped to your workspace

The MCP server authenticates with the same `tvk_...` API key as the rest of the Tanvik API, and every tool call is **scoped to your own client account**. Claude can only ever see and act on your workspace's data — never another client's, and never anything requiring Tanvik super-admin access.

## Safe by default

The server splits tools into two categories:

<CardGroup cols={2}>
  <Card title="Read-only tools" icon="eye">
    Let Claude view data — leads, contacts, conversations, orders, wallet, and more. **On by default.**
  </Card>

  <Card title="Action tools" icon="bolt">
    Let Claude change things — send a message, create a ticket. **Off by default**, until you turn them on.
  </Card>
</CardGroup>

You control exactly which tools Claude can use from the [Permissions](/mcp/permissions) page in your dashboard. Every call is recorded in an audit log.

## Requirements

<Steps>
  <Step title="A Pro or Enterprise plan">
    MCP access is part of API access, which is available on Pro and Enterprise plans. If your plan doesn't include it, you'll see an upgrade prompt.
  </Step>

  <Step title="A Tanvik API key">
    The MCP connection is authorized with a `tvk_...` key generated from **Settings → API Keys**. See [Authentication](/authentication).
  </Step>

  <Step title="An MCP-compatible client">
    Claude (web, desktop, or mobile) on a plan that supports custom connectors. Any other MCP-compatible client works too.
  </Step>
</Steps>

## Next steps

<CardGroup cols={3}>
  <Card title="Connect Claude" icon="plug" href="/mcp/connect">
    Add the Tanvik connector and authorize it.
  </Card>

  <Card title="Permissions" icon="toggle-on" href="/mcp/permissions">
    Choose what Claude is allowed to do.
  </Card>

  <Card title="Available tools" icon="screwdriver-wrench" href="/mcp/tools">
    Browse everything the MCP server exposes.
  </Card>
</CardGroup>