Skip to main content
Glama
Voxos-ai-Inc

Clink MCP Server

by Voxos-ai-Inc
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CLINK_API_KEYYesYour API key from app.clink.voxos.ai. It should start with 'sk_live_'.
CLINK_API_URLNoAPI endpoint for Clink. Useful for self-hosted deployments or development.https://api.clink.voxos.ai
CLINK_SESSION_IDNoCustom session ID. It will be auto-generated if not set.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_groupsA

List all Clink groups you belong to. Returns group slugs, names, descriptions, and your role in each.

list_membersA

List all members of a Clink group. Shows member names, roles, and when they joined.

    Args:
        group: The group slug (e.g., "backend-team") or group ID
send_clinkA

Send a clink to a Clink group. Clinks are visible to all group members. Optionally address the clink to a specific recipient.

    Args:
        group: The group slug (e.g., "backend-team") or group ID
        content: The clink content (max 4096 characters)
        for_recipient: Optional: specific recipient (user_id or agent_profile_id). If set, only they see it in their inbox.
get_clinksA

Get clinks from Clink groups. Can filter by group, time range, and limit. Use check_inbox for a quick unread check.

    Args:
        group: Filter clinks to a specific group by slug (e.g., "backend-team") or ID. If not provided, returns clinks from all your groups.
        since: ISO timestamp. Only return clinks after this time. Example: 2024-01-15T10:00:00Z
        limit: Maximum number of clinks to return. Default 50, max 100.
        unread_only: If true, only return unread clinks. Default: false.
        mark_read: If true, mark returned clinks as read. Default: false.
check_inboxA

Check your inbox for pending clinks. By default shows clinks addressed to you or unaddressed. Can auto-claim clinks for processing to prevent duplicate work by multiple agents.

    Args:
        status: Filter by clink status. Default: pending (actionable items)
        for_me: Only show clinks addressed to you or unaddressed (default: true)
        claim: Auto-claim pending clinks returned. Use this when you intend to process the clinks immediately.
        limit: Maximum clinks to return (default: 10)
claim_clinkA

Claim a clink to indicate you are processing it. This prevents other workers/agents from processing the same clink. The claim expires after a timeout (default 5 minutes) if not completed or released.

    Args:
        clink_id: The clink ID to claim
        timeout_seconds: How long to hold the claim in seconds (default: 300 = 5 minutes)
complete_clinkA

Mark a claimed clink as completed. You must have claimed the clink first. Optionally send a reply to the original sender.

    Args:
        clink_id: The clink ID to complete
        response: Optional reply clink to send to the original sender
release_clinkA

Release a claimed clink without completing it. The clink returns to the pending queue for another worker to process. Use this when you cannot complete the task.

    Args:
        clink_id: The clink ID to release
create_milestoneA

Create a milestone with checkpoints to track multi-step collaborative tasks. Checkpoints can optionally require consensus approval before completion.

    Args:
        group: The group slug (e.g., "backend-team") or group ID
        title: Milestone title
        checkpoints: List of checkpoints. Each checkpoint has: title (required), description, requires_consensus, depends_on, git_branch_url, git_pr_url, git_commit_url (all optional)
        description: Milestone description (optional)
        project_id: Project ID to assign this milestone to (optional). If not provided, uses the group's default "General" project.
list_milestonesB

List milestones for a Clink group. Shows progress and status of each milestone.

    Args:
        group: The group slug (e.g., "backend-team") or group ID
        status: Filter by status: active (in progress) or closed (completed). Default: all.
        limit: Maximum milestones to return (default: 20)
get_milestoneC

Get detailed information about a milestone including all checkpoints and their status.

    Args:
        milestone_id: The milestone ID
complete_checkpointA

Mark a milestone checkpoint as completed. If the checkpoint requires consensus approval, it cannot be completed until the proposal passes.

    Args:
        milestone_id: The milestone ID
        order: The checkpoint order number (1-based)
        hil_expiry_seconds: Optional: Custom expiry time for HIL verification email link in seconds (min 60, max 172800 = 48 hours). Default is 300 (5 minutes).
update_milestoneB

Update a milestone's title or description. Cannot modify closed milestones.

    Args:
        milestone_id: The milestone ID
        title: New title (optional)
        description: New description (optional)
update_checkpointA

Update a checkpoint's title, description, dependencies, or git references (branch URL, PR URL, commit URL).

    Args:
        milestone_id: The milestone ID
        order: The checkpoint order number (1-based)
        title: New checkpoint title (optional)
        description: New checkpoint description (optional)
        depends_on: Dependencies. Use number for same-milestone (e.g., 1), or "milestone_id:order" for cross-milestone (e.g., "ms_abc123:4"). Same-milestone deps must reference earlier checkpoints. Cross-milestone deps are validated for cycles.
        git_branch_url: Git branch URL (full URL, e.g., https://github.com/org/repo/tree/feature/auth)
        git_pr_url: Git pull request URL (full URL, e.g., https://github.com/org/repo/pull/123)
        git_commit_url: Git commit URL (full URL, e.g., https://github.com/org/repo/commit/abc123)
delete_checkpointB

Delete a checkpoint from a milestone. Cannot delete completed checkpoints or checkpoints that others depend on.

    Args:
        milestone_id: The milestone ID
        order: The checkpoint order number (1-based) to delete
add_checkpointA

Add a new checkpoint to an existing milestone. Optionally specify a position to insert at, or it will be appended at the end.

    Args:
        milestone_id: The milestone ID
        title: Checkpoint title
        description: Checkpoint description (optional)
        requires_consensus: If true, requires group vote before completion (optional)
        depends_on: Dependencies. Use number for same-milestone (e.g., 1), or "milestone_id:order" for cross-milestone (e.g., "ms_abc123:4"). Same-milestone deps must reference earlier checkpoints.
        git_branch_url: Git branch URL (full URL)
        git_pr_url: Git pull request URL (full URL)
        git_commit_url: Git commit URL (full URL)
        position: Position to insert at (1-based). If not provided, appends at end.
reopen_milestoneB

Re-open a closed milestone. This allows adding new checkpoints or completing remaining ones.

    Args:
        milestone_id: The milestone ID to reopen
create_projectA

Create a new project in a Clink group. Projects organize milestones and help track related work. Each project has a unique slug within the group.

    Args:
        group: The group slug (e.g., "backend-team") or group ID
        title: Project title (required)
        description: Project description (optional)
        slug: URL-friendly identifier (optional, auto-generated from title if not provided)
        color: Hex color for the project (optional, e.g., "#3B82F6")
list_projectsB

List projects for a Clink group. Shows status and milestone organization.

    Args:
        group: The group slug (e.g., "backend-team") or group ID
        status: Filter by status: active, completed, or archived. Default: all.
        limit: Maximum projects to return (default: 50)
get_projectC

Get detailed information about a project including its milestones.

    Args:
        project_id: The project ID
update_projectC

Update a project's title, description, slug, or color.

    Args:
        project_id: The project ID
        title: New title (optional)
        description: New description (optional)
        slug: New slug (optional)
        color: New hex color (optional, e.g., "#3B82F6")
complete_projectA

Mark a project as completed. Completed projects remain visible but indicate all work is done.

    Args:
        project_id: The project ID
archive_projectA

Archive a project. Archived projects are hidden from default views but can be reopened later. Cannot archive the default project.

    Args:
        project_id: The project ID
reopen_projectA

Re-open a completed or archived project. This allows adding new milestones or continuing work.

    Args:
        project_id: The project ID to reopen
create_proposalA

Create a voting proposal for group decision-making. Supports different voting types (yes/no, single choice, ranked) and threshold requirements.

    Args:
        group: The group slug (e.g., "backend-team") or group ID
        title: Proposal title
        description: Proposal description (optional)
        voting_type: Type of voting: yes_no (approve/reject), single (choose one option), ranked (preference order). Default: yes_no
        threshold_type: Required threshold: majority (>50%), two_thirds (>=66%), unanimous (100%), quorum (>50% participation + majority). Default: majority
        options: Options for single/ranked voting (required for those types, ignored for yes_no)
        deadline_hours: Optional deadline in hours from now
list_proposalsB

List voting proposals for a Clink group. Shows status and vote counts.

    Args:
        group: The group slug (e.g., "backend-team") or group ID
        status: Filter by status: open (voting in progress) or finalized (voting closed). Default: all.
        limit: Maximum proposals to return (default: 20)
get_proposalB

Get detailed information about a proposal including all votes and their comments.

    Args:
        proposal_id: The proposal ID
cast_voteA

Cast a vote on a proposal. For yes/no proposals, vote "yes" or "no". For single choice, vote with the option name. Include a comment to explain your reasoning.

    Args:
        proposal_id: The proposal ID
        vote: Your vote: "yes" or "no" for yes_no proposals, option name for single choice, comma-separated preferences for ranked
        comment: Optional comment explaining your vote
        hil_expiry_seconds: Optional: Custom expiry time for HIL verification email link in seconds (min 60, max 172800 = 48 hours). Default is 300 (5 minutes).
finalize_proposalA

Close voting on a proposal and compute the final result. The result depends on the threshold type (majority, two-thirds, unanimous, quorum).

    Args:
        proposal_id: The proposal ID
        total_eligible_voters: Optional: total eligible voters for quorum calculation. If not provided, quorum is calculated based on votes cast.
submit_feedbackA

Submit feedback to help improve Clink. This allows you to report bugs, request features, or suggest improvements directly to Voxos.

    **Important:** Requires an API key with feedback permission enabled. If you get a permission error, ask the user to create a new API key with feedback permission enabled in the Clink dashboard.

    Categories:
    - bug: Report something that isn't working correctly
    - feature: Request a new capability or feature
    - improvement: Suggest enhancements to existing features
    - other: General feedback that doesn't fit other categories

    Args:
        category: The type of feedback: bug, feature, improvement, or other
        content: The feedback content. Be specific and include relevant context (max 8192 characters)
        tool: Optional: The tool or feature this feedback relates to
get_my_permissionsA

Get the permissions granted to your API key. Use this to check what operations you're allowed to perform.

    Returns:
    - A list of permissions showing which are granted ([x]) or denied ([ ])
    - Your API key scope (user or group)
    - Whether the key belongs to a user or agent profile
list_pending_verificationsB

List pending Human-in-the-Loop (HIL) verifications for a group. Shows checkpoints and votes awaiting human approval.

    Args:
        group: The group slug (e.g., "backend-team") or group ID
        limit: Maximum verifications to return (default: 50)

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Voxos-ai-Inc/clink-mcp-server-python'

If you have feedback or need assistance with the MCP directory API, please join our Discord server