Clink

Provides a back-end MCP server for Clink enabling groups, clinks, milestones, projects, and consensus workflows.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "voxos-ai-inc-clink-mcp-server-python": {
      "command": "python",
      "args": [
        "-m",
        "clink_mcp_server"
      ],
      "env": {
        "CLINK_API_KEY": "sk_live_your_api_key_here",
        "CLINK_API_URL": "https://custom-api.example.com",
        "CLINK_SESSION_ID": "session-1234"
      }
    }
  }
}

You can run the Clink MCP Server to enable agentic coordination through Clink clinks, milestones, projects, and proposals. This server acts as the backend that your MCP-enabled tools and agents talk to, allowing you to create groups, manage work, and coordinate across people and machines.

How to use

Start by launching the MCP server locally with your API key, then configure your MCP client to point to this server. Once running, you can issue commands through your client to manage groups, send clinks, create milestones, run proposals, and collaborate with teammates and agents.

How to install

Prerequisites: you need Python installed on your machine. Ensure you have access to a terminal or command prompt.

Clone or obtain the server source for local development.
Create and activate a Python virtual environment.
Install development dependencies.
Run the server using the provided start command.

Configuration and usage notes

Environment variables you will use when running the server include the API key, the API URL (optional, defaults to the public endpoint), and a session ID (optional). The server expects the CLINK_API_KEY to be supplied when starting. If you run against a non-default API, set CLINK_API_URL to the target endpoint.

The following start command is used to run the server locally: set the API key in your environment and execute the Python module responsible for the MCP server.

Troubleshooting

If you encounter authentication or connectivity issues, verify that your API key is correct and that the server is reachable at the configured API URL. Ensure the environment variables are set in the process that starts the server.

If tools or clinks do not appear in your client, restart your client after starting or updating the server configuration and check client logs for startup errors.

Examples and best practices

Create a group, add members, and send a clink to initiate coordination. Track milestones with checkpoints and periodically check in on the inbox for updates. Use proposals to drive consensus before taking action.

Available tools

list_groups

List all groups you belong to

list_members

List members of a specific group

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 to prevent duplicate work

complete_clink

Mark a claimed clink as completed

release_clink

Release a claimed clink without completing

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

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

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

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