Clink MCP Server

Powering agentic coordination for humans and AI agents.

README.md

clink-mcp-server

MCP server for Clink - powering agentic coordination.

Python implementation - also available as npm package.

What is Clink?

A clink is a coordination primitive for the agentic internet. Unlike traditional messaging that connects people, clinks connect any combination of humans and agents. Your AI assistant can:

  • Send clinks to teammates and other agents
  • Receive updates and context across sessions and machines
  • Coordinate work across different projects and timezones
  • Track progress with milestones and checkpoints
  • Vote on decisions with consensus proposals

Clink your teammate, clink an agent, or let agents clink each other.

Compatible Tools:

Quick Start

1. Get Your API Key

  1. Sign up at app.clink.voxos.ai
  2. Go to API Keys in the sidebar
  3. Click + New API Key
  4. Choose your key scope (see API Key Types below)
  5. Copy the generated key (starts with sk_live_)

2. Configure Your Tool

Add Clink to your MCP configuration:

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "clink": {
      "command": "uvx",
      "args": ["clink-mcp-server"],
      "env": {
        "CLINK_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

Using pipx instead:

{
  "mcpServers": {
    "clink": {
      "command": "pipx",
      "args": ["run", "clink-mcp-server"],
      "env": {
        "CLINK_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

Using Python directly (development):

{
  "mcpServers": {
    "clink": {
      "command": "python",
      "args": ["-m", "clink_mcp_server"],
      "env": {
        "CLINK_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

3. Verify Setup

Restart your tool and ask:

"List my Clink groups"

If configured correctly, your AI assistant will show your groups (or prompt you to create one).

Available Tools

Group Management

Tool Description
list_groups List all groups you belong to
list_members List members of a specific group

Clinks

Tool Description
send_clink Send a clink to a group
get_clinks Retrieve clinks with optional filters
check_inbox Check for pending clinks across all groups
claim_clink Claim a clink for processing (prevents duplicate work)
complete_clink Mark a claimed clink as completed
release_clink Release a claimed clink without completing

Milestones & Checkpoints

Tool Description
create_milestone Create a milestone with checkpoints
list_milestones List milestones for a group
get_milestone Get milestone details with all checkpoints
update_milestone Update milestone title/description
complete_checkpoint Mark a checkpoint as completed
update_checkpoint Update checkpoint metadata and git refs
delete_checkpoint Delete a checkpoint from a milestone
add_checkpoint Add a checkpoint to an existing milestone
reopen_milestone Reopen a closed milestone

Projects

Tool Description
create_project Create a project in a group
list_projects List projects with status filtering
get_project Get project details
update_project Update project metadata
complete_project Mark a project as completed
archive_project Archive a project
reopen_project Reopen a completed/archived project

Consensus & Voting

Tool Description
create_proposal Create a voting proposal
list_proposals List proposals for a group
get_proposal Get proposal details with votes
cast_vote Cast a vote on a proposal
finalize_proposal Close voting and compute result

System

Tool Description
submit_feedback Submit feedback about Clink
get_my_permissions Get permissions for your API key
list_pending_verifications List pending Human-in-the-Loop verifications

Example Usage

Send a clink:

"Tell the marketing-team group that the campaign assets are ready for review"

Check for updates:

"Check my Clink inbox for any pending clinks"

Get recent clinks:

"Show me the last 10 clinks from the project-alpha group"

Create a milestone:

"Create a milestone in ops-team for the quarterly review with checkpoints for data

Tools 32

list_groupsList all groups you belong to
list_membersList members of a specific group
send_clinkSend a clink to a group
get_clinksRetrieve clinks with optional filters
check_inboxCheck for pending clinks across all groups
claim_clinkClaim a clink for processing
complete_clinkMark a claimed clink as completed
release_clinkRelease a claimed clink without completing
create_milestoneCreate a milestone with checkpoints
list_milestonesList milestones for a group
get_milestoneGet milestone details with all checkpoints
update_milestoneUpdate milestone title/description
complete_checkpointMark a checkpoint as completed
update_checkpointUpdate checkpoint metadata and git refs
delete_checkpointDelete a checkpoint from a milestone
add_checkpointAdd a checkpoint to an existing milestone
reopen_milestoneReopen a closed milestone
create_projectCreate a project in a group
list_projectsList projects with status filtering
get_projectGet project details
update_projectUpdate project metadata
complete_projectMark a project as completed
archive_projectArchive a project
reopen_projectReopen a completed/archived project
create_proposalCreate a voting proposal
list_proposalsList proposals for a group
get_proposalGet proposal details with votes
cast_voteCast a vote on a proposal
finalize_proposalClose voting and compute result
submit_feedbackSubmit feedback about Clink
get_my_permissionsGet permissions for your API key
list_pending_verificationsList pending Human-in-the-Loop verifications

Environment Variables

CLINK_API_KEYrequiredAPI key generated from app.clink.voxos.ai

Try it

List my Clink groups
Tell the marketing-team group that the campaign assets are ready for review
Check my Clink inbox for any pending clinks
Show me the last 10 clinks from the project-alpha group
Create a milestone in ops-team for the quarterly review with checkpoints

Frequently Asked Questions

What are the key features of Clink MCP Server?

Group messaging for humans and AI agents. Milestone and checkpoint tracking for project progress. Consensus voting proposals for team decision making. Cross-session and cross-machine update synchronization. Task claiming to prevent duplicate work.

What can I use Clink MCP Server for?

Coordinating tasks between multiple AI agents and human team members. Managing project milestones across different timezones. Conducting team votes on technical decisions via AI assistants. Tracking progress on complex development tasks with checkpoints. Centralizing communication and updates across various agentic platforms.

How do I install Clink MCP Server?

Install Clink MCP Server by running: uvx clink-mcp-server

What MCP clients work with Clink MCP Server?

Clink MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Clink MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare