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:
- Claude Code (Anthropic)
- Cursor
- Windsurf
- GitHub Copilot
- Zed
- Roo Code
- Continue
- ChatGPT Desktop
- Any tool supporting MCP
Quick Start
1. Get Your API Key
- Sign up at app.clink.voxos.ai
- Go to API Keys in the sidebar
- Click + New API Key
- Choose your key scope (see API Key Types below)
- 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 tolist_membersList members of a specific groupsend_clinkSend a clink to a groupget_clinksRetrieve clinks with optional filterscheck_inboxCheck for pending clinks across all groupsclaim_clinkClaim a clink for processingcomplete_clinkMark a claimed clink as completedrelease_clinkRelease a claimed clink without completingcreate_milestoneCreate a milestone with checkpointslist_milestonesList milestones for a groupget_milestoneGet milestone details with all checkpointsupdate_milestoneUpdate milestone title/descriptioncomplete_checkpointMark a checkpoint as completedupdate_checkpointUpdate checkpoint metadata and git refsdelete_checkpointDelete a checkpoint from a milestoneadd_checkpointAdd a checkpoint to an existing milestonereopen_milestoneReopen a closed milestonecreate_projectCreate a project in a grouplist_projectsList projects with status filteringget_projectGet project detailsupdate_projectUpdate project metadatacomplete_projectMark a project as completedarchive_projectArchive a projectreopen_projectReopen a completed/archived projectcreate_proposalCreate a voting proposallist_proposalsList proposals for a groupget_proposalGet proposal details with votescast_voteCast a vote on a proposalfinalize_proposalClose voting and compute resultsubmit_feedbackSubmit feedback about Clinkget_my_permissionsGet permissions for your API keylist_pending_verificationsList pending Human-in-the-Loop verificationsEnvironment Variables
CLINK_API_KEYrequiredAPI key generated from app.clink.voxos.ai