> For the complete documentation index, see [llms.txt](https://hinkal-team.gitbook.io/hinkal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hinkal-team.gitbook.io/hinkal/hinkal-mcp/quickstart.md).

# Quickstart

No wallet to connect and nothing to fund up front — Hinkal creates a custodial wallet for you server-side on first use. Your machine keeps only an access key.

{% stepper %}
{% step %}

#### Connect the server to your MCP client

**Recommended — global install** (faster startup, explicit updates):

```bash
npm i -g @hinkal/mcp
```

{% tabs %}
{% tab title="Claude Code" %}
{% code overflow="wrap" %}

```bash
claude mcp add hinkal -- hinkal-mcp
```

{% endcode %}
{% endtab %}

{% tab title="Claude Desktop" %}
Open the configuration file: top-left menu → **Developer** → **Open app config**.

Add Hinkal:

{% code overflow="wrap" %}

```json
{
  "mcpServers": {
    "hinkal": { "command": "hinkal-mcp" }
  }
}
```

{% endcode %}

Restart Claude Desktop.

No global install? Use this configuration instead:

{% code overflow="wrap" %}

```json
{
  "mcpServers": {
    "hinkal": {
      "command": "npx",
      "args": ["-y", "@hinkal/mcp@latest"]
    }
  }
}
```

{% endcode %}
{% endtab %}

{% tab title="Codex" %}
{% code overflow="wrap" %}

```bash
codex mcp add hinkal -- hinkal-mcp
```

{% endcode %}
{% endtab %}

{% tab title="Cursor or Windsurf" %}
Add to `~/.cursor/mcp.json` (or `~/.codeium/windsurf/mcp_config.json`):

{% code overflow="wrap" %}

```json
{
  "mcpServers": {
    "hinkal": { "command": "hinkal-mcp" }
  }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

No environment variables required over stdio — everything has a default (see Configuration).
{% endstep %}

{% step %}

#### Get your wallet address and fund it

Ask the assistant for your wallet addresses — it calls `get_wallet_addresses`. The wallet starts empty. Send the token you want to shield plus native gas (ETH, POL, …) to the address for your chain.
{% endstep %}

{% step %}

#### Move funds

Ask in plain language - for example *"deposit 100 USDC on Polygon"*. The server resolves the symbol, builds the deposit, signs and broadcasts it, and returns `{ txHash, explorerUrl, executed: true }`.
{% endstep %}
{% endstepper %}