# Connect the Blueink MCP Server

The Blueink MCP server lets AI assistants interact with your Blueink account — search envelopes, check signer status, download documents, and more — all through natural language.

**Server URL:** `https://mcp.blueink.com/mcp`

**Authentication:** Uses the same API key as the Blueink REST API, passed as an `Authorization: Token <your_api_key>` header.

> **Tip**
>
> If you don't have an API key yet, visit the [Authentication guide](/docs/esignature-api/authentication/) to learn how to obtain one.

## Setup by Client

#### Claude Code

Run this command in your terminal:

```bash
claude mcp add --transport http blueink https://mcp.blueink.com/mcp \
  --header "Authorization: Token your_api_key_here"
```

That's it — the server will be available the next time you start a Claude Code session.

#### Cursor

1. Open **Cursor Settings** → **MCP**.
2. Click **Add new MCP server**.
3. Choose **Type**: `http` (streamable HTTP).
4. Enter the URL: `https://mcp.blueink.com/mcp`
5. Add the header `Authorization: Token your_api_key_here`.

Or add it directly to your project's `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "blueink": {
      "type": "http",
      "url": "https://mcp.blueink.com/mcp",
      "headers": {
        "Authorization": "Token your_api_key_here"
      }
    }
  }
}
```

#### Windsurf

Edit your Windsurf MCP configuration file at `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "blueink": {
      "type": "http",
      "serverUrl": "https://mcp.blueink.com/mcp",
      "headers": {
        "Authorization": "Token your_api_key_here"
      }
    }
  }
}
```

Restart Windsurf after saving.

#### VS Code (Copilot)

Add the server to your VS Code `settings.json` (open via **Cmd/Ctrl + Shift + P** → **Preferences: Open User Settings (JSON)**):

```json
{
  "mcp": {
    "servers": {
      "blueink": {
        "type": "http",
        "url": "https://mcp.blueink.com/mcp",
        "headers": {
          "Authorization": "Token your_api_key_here"
        }
      }
    }
  }
}
```

#### Other Clients

Any MCP client that supports **Streamable HTTP** transport can connect. Use these settings:

| Setting | Value |
|---|---|
| **URL** | `https://mcp.blueink.com/mcp` |
| **Transport** | Streamable HTTP |
| **Auth Header** | `Authorization: Token your_api_key_here` |

## What You Can Do

Once connected, ask your AI assistant things like:

- *"Show me my recent envelopes"*
- *"What's the status of envelope abc123?"*
- *"Find envelopes sent to john@example.com"*
- *"Download the signed PDF for envelope xyz789"*

## Need Help?

- [Authentication guide](/docs/esignature-api/authentication/) — Get your API key
- [API Reference](/docs/api/) — Full endpoint documentation
- [Support Center](https://help.blueink.com) — Additional resources