Skip to main content
Glama

@botdigit/mcp-server

Official Model Context Protocol (MCP) server for BotDigit Work OS.

Safely connect your local AI development environment (Cursor, Claude Desktop, Windsurf, ChatGPT Custom Actions) to BotDigit projects, milestones, tasks, Git delivery workflows, and escrow safety controls.


Quickstart

1. Cursor IDE Configuration

Add the following to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "botdigit": {
      "command": "npx",
      "args": ["-y", "@botdigit/mcp-server"],
      "env": {
        "BOTDIGIT_PAT": "bdt_pat_your_token_here",
        "BOTDIGIT_API_URL": "https://api.botdigit.com/api/v1/mcp"
      }
    }
  }
}

2. Claude Desktop Configuration

Add the following to your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "botdigit": {
      "command": "npx",
      "args": ["-y", "@botdigit/mcp-server"],
      "env": {
        "BOTDIGIT_PAT": "bdt_pat_your_token_here"
      }
    }
  }
}

3. Claude Code & Cowork Plugin

This repository includes a native Claude Code / Cowork plugin bundle.

Slash Commands

  • /find-projects — Search open freelance projects, client RFPs, and development gigs.

  • /draft-proposal — Analyze client requirements and stage proposal drafts for human review.

  • /check-contracts — Monitor active milestones, deliverables, and funded escrow.

Set your token:

export BOTDIGIT_API_TOKEN="bdt_pat_your_token_here"

Related MCP server: upwork-mcp

The 17 Native MCP Tools

Phase

Tool Name

Description

Phase 1: Discovery

search_projects

Search open marketplace projects, RFPs, and freelance gigs

get_project

Complete project specifications, milestones, and funding status

get_workspace

Workspace collaboration state, members, roles, active tasks

get_milestones

Milestones, acceptance criteria, deadlines, escrow status

get_project_status

One-shot executive rollup (% complete, tasks, escrow)

Phase 2: Management

search_freelancers

Search verified talent with skills, rating, completed projects

get_freelancer

Verified profile, hourly rates, portfolio, GitHub verification

create_project

Create new client project draft with milestone structure

create_task

Create Kanban tasks on project board with priority & assignees

update_task

Update task status (todo, in_progress, done) and notes

Phase 3: Delivery

get_git_activity

Query linked Git commits, pull requests, issues, repo status

link_commit_to_milestone

Associate a commit SHA or PR to milestone evidence

submit_deliverable

Stage deliverable with work summary, URLs, and AI notes

get_deliverables

List staged deliverables, review status, and freelancer info

verify_milestone_completion

4-point verification readiness check (tasks, Git, artifacts)

Phase 4: Financial Safety

prepare_milestone_payment

Stage payment with cryptographic token & 1-click client approval

get_payment_approval_status

Check if client authorized or executed milestone payment


Architectural Principle: Financial Safety

"AI prepares, BotDigit verifies, Humans authorize."

Autonomous AI agents cannot execute payment transfers or escrow releases autonomously. The prepare_milestone_payment tool generates a cryptographic approval token and a 1-click web approval link (https://botdigit.com/approvals/payment/:token) for the verified client to review and authorize.


Testing Your Connection

npx @botdigit/mcp-server --test-connection

License

MIT © BotDigit Inc.

Available Tools

13 tools
botdigit_approve_proposal_draftA

Approve and dispatch a staged proposal draft, officially submitting it to the client.

Inputs: draft_id (required).

botdigit_get_contractA

Get detailed contract data including escrow status, terms, and parties.

Inputs: contract_id (required).

botdigit_get_projectA

Fetch complete details and specifications for a single BotDigit project by UUID.

Inputs: project_id (required).

botdigit_get_threadB

Get full message history for a specific conversation thread.

Inputs: thread_id (required).

botdigit_list_contract_milestonesB

List milestones and escrow funding for a specific contract.

Inputs: contract_id (required).

botdigit_list_contractsB

List your active and completed contracts, escrows, and project orders.

Inputs: status.

botdigit_list_messagesC

List active client/freelancer messaging threads.

Inputs: page, limit.

botdigit_list_my_bidsA

Retrieve your active and historical bids across BotDigit marketplace projects.

Inputs: page, limit.

botdigit_list_projectsB

Search and browse live marketplace projects on BotDigit. Supports category filters, text search, and pagination.

Inputs: page, limit, search, category.

botdigit_list_proposal_draftsA

List all staged proposal drafts currently waiting for human approval or rejection in your workspace.

Inputs: no named parameters.

botdigit_stage_delivery_draftC

Stage a milestone deliverable submission for client review and escrow release.

Inputs: notes (required), milestone_id (required), attachment_urls.

botdigit_stage_message_draftA

Stage a message draft reply to a client thread for human review.

Inputs: content (required), thread_id (required).

botdigit_stage_proposal_draftA

Stage a proposal draft for a client project on BotDigit. Safe autonomous workflow: creates a draft in your dashboard for your review before live submission.

Inputs: bid_amount (required), project_id (required), cover_letter (required), estimated_duration (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 13 tools

    Disambiguation4/5

    Each tool targets a fairly distinct resource and action (projects, proposal drafts, bids, messages, contracts, milestones). The main overlap risk is between proposal drafts, bids, and projects, but the descriptions clarify that projects are marketplace listings, drafts are staged, and bids are submitted. Minor boundary blur between a staged proposal draft and a submitted bid.

    Naming Consistency5/5

    Every tool uses the botdigit_ prefix followed by a clean verb_noun pattern (list_projects, get_project, stage_proposal_draft, approve_proposal_draft, get_thread, etc.). The 'stage' action verb is applied uniformly across drafts. No mixing of conventions.

    Tool Count5/5

    13 tools sit comfortably in the well-scoped 3-15 range. Each tool maps to a distinct operation across the browse/stage/approve/list workflow, with no obviously redundant tools.

    Completeness3/5

    Core flows (browse projects, stage/approve proposals, read messages, view contracts/milestones) are covered, but the lifecycle is asymmetric: proposals have both stage and approve tools, while messages and delivery drafts can only be staged with no matching approve tool. There is also no get for proposal drafts and no way to reject/decline a draft or bid, creating potential dead ends.

    Related MCP Connectors

    Related MCP Servers