bink-mcp

MCP server for managing your Bink link-in-bio page via AI assistants.

Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

Quick Start

1. Get your API Token

Go to binatomy.link/settings > Developer section > Create Token.

Your token will look like bink_abc123... — save it, it's shown only once.

2. Configure your MCP client

Claude Code (.claude/settings.json):

{
  "mcpServers": {
    "bink": {
      "command": "npx",
      "args": ["-y", "bink-mcp"],
      "env": {
        "BINK_API_TOKEN": "bink_your_token_here"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "bink": {
      "command": "npx",
      "args": ["-y", "bink-mcp"],
      "env": {
        "BINK_API_TOKEN": "bink_your_token_here"
      }
    }
  }
}

Cursor (MCP settings):

{
  "bink": {
    "command": "npx",
    "args": ["-y", "bink-mcp"],
    "env": {
      "BINK_API_TOKEN": "bink_your_token_here"
    }
  }
}

3. Start using it

Ask your AI assistant things like:

• "Show me my Bink blocks"
• "Add a new link to my portfolio"
• "What are my page analytics?"
• "List my inbox messages"
• "Create a contact form"

Available Tools

Profile

| Tool | Description | |------|-------------| | get_profile | Get your user profile | | update_profile | Update name, email, inbox settings |

Blocks

| Tool | Description | |------|-------------| | list_blocks | List all blocks on your page | | create_block | Create a new block (LINK, HEADER, SOCIAL, FORM, BOOKING, etc.) | | update_block | Update block content or visibility | | delete_block | Remove a block | | reorder_blocks | Change block positions |

Page

| Tool | Description | |------|-------------| | update_page_settings | Update title, description, SEO metadata | | update_page_theme | Change page theme (colors, fonts, spacing) | | toggle_page_publish | Publish or unpublish your page |

Forms

| Tool | Description | |------|-------------| | list_forms | List all forms | | get_form | Get form details with fields | | create_form | Create a new form | | update_form | Update form settings | | get_form_responses | View form submissions |

Messages

| Tool | Description | |------|-------------| | list_messages | List inbox messages | | get_message | Read a message | | toggle_message_read | Mark read/unread | | delete_message | Delete a message |

Analytics

| Tool | Description | |------|-------------| | get_analytics | Page views, clicks, top blocks (30 days) |

Bookings

| Tool | Description | |------|-------------| | list_bookings | List your bookings | | update_booking_status | Confirm or cancel a booking |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | BINK_API_TOKEN | Yes | Your Personal Access Token (starts with bink_) | | BINK_API_URL | No | API base URL (default: https://binatomy.link) |

Development

cd packages/mcp-server
npm install
npm run build

Test locally with MCP Inspector:

BINK_API_TOKEN=bink_xxx npx @modelcontextprotocol/inspector node build/index.js

License

MIT