Botdigit MCP
@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.jsonWindows:
%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 open marketplace projects, RFPs, and freelance gigs |
| Complete project specifications, milestones, and funding status | |
| Workspace collaboration state, members, roles, active tasks | |
| Milestones, acceptance criteria, deadlines, escrow status | |
| One-shot executive rollup (% complete, tasks, escrow) | |
Phase 2: Management |
| Search verified talent with skills, rating, completed projects |
| Verified profile, hourly rates, portfolio, GitHub verification | |
| Create new client project draft with milestone structure | |
| Create Kanban tasks on project board with priority & assignees | |
| Update task status ( | |
Phase 3: Delivery |
| Query linked Git commits, pull requests, issues, repo status |
| Associate a commit SHA or PR to milestone evidence | |
| Stage deliverable with work summary, URLs, and AI notes | |
| List staged deliverables, review status, and freelancer info | |
| 4-point verification readiness check (tasks, Git, artifacts) | |
Phase 4: Financial Safety |
| Stage payment with cryptographic token & 1-click client approval |
| 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-connectionLicense
MIT © BotDigit Inc.
Available Tools
13 toolsbotdigit_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
Scored across 13 tools
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.
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.
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.
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
Connect your AI agent to 300+ methods and 100+ live tools
Connect AI agents to discover services and coordinate real-world tasks.
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Verified, pay-per-use API tools for AI agents through one authenticated connection.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to post tasks, manage escrow, approve work, and pay human gig workers on the GetterDone physical-task marketplace.16490 npmMIT
- AlicenseNot gradedqualityDmaintenanceConnects AI agents to Upwork's GraphQL API, enabling job discovery, proposal management, profile tracking, and analytics.10 npm2MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to vet a developer's shipped products, check fixed pricing and availability, and submit project briefs on behalf of users.1MIT
- FlicenseNot gradedqualityBmaintenanceProvides AI agents with production-ready integrations for GitHub repository management, sandboxed code execution, SFTP file operations, web search and scraping, YouTube, Google Workspace, Notion, and more.-