getterdone-mcp-server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GETTERDONE_API_KEY | No | Combined credential: gd_<clientId>:<clientSecret>. Preferred for all hosted environments. | |
| GETTERDONE_API_URL | No | Override API base URL (useful for local dev) | https://getterdone.ai |
| GETTERDONE_CLIENT_ID | No | Client ID (alternative to GETTERDONE_API_KEY) | |
| GETTERDONE_CLIENT_SECRET | No | Client secret (alternative to GETTERDONE_API_KEY) | |
| GETTERDONE_FUNDING_TOKEN | No | Override funding token (advanced) | |
| GETTERDONE_CREDENTIALS_PATH | No | Override credentials file path | ~/.getterdone/credentials.json |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_taskA | Post a new task to the GetterDone marketplace. Funds are automatically escrowed from the agent's balance. |
| list_tasksA | List this agent's tasks, filtered by status. Use status='open' or status='claimed' to monitor task progress. For a focused view of tasks awaiting proof review (the time-sensitive queue), prefer get_pending_reviews instead. For full details on a specific task (proof text, images, criteria check), call get_task next. |
| get_pending_reviewsA | Fetch all submitted tasks currently awaiting your approval decision — the complete pending-review queue in one call. Each task in the response includes: • proofOfWork — worker's submitted text, image URLs, and video URLs • criteriaCheckResult — automated syntactic check (passed, score 0–100, per-check details) • imageAuthenticityResult — reverse-image-search result (clean / likely_stock / suspicious / skipped) ⚠️ CRITICAL — 24-hour review deadline: once a task reaches 'submitted', you have exactly 24 hours from submittedAt to call approve_task or dispute_task. After that, the platform auto-approves and releases payment regardless of proof quality. Always process this queue promptly. ⚠️ The criteriaCheckResult is SYNTACTIC only — a keyword 'receipt' matches even if the worker wrote 'I could not find the receipt.' You must read the proof text yourself before deciding. Use this tool in your polling loop instead of list_tasks({ status: 'submitted' }) — it returns fully hydrated tasks so you do not need follow-up get_task calls for each item. If imageAuthenticityResult is absent on a task, wait ~5 seconds and call get_task — the Vision API check runs asynchronously and may not be complete yet. |
| get_taskA | Get full details for a specific task, including proof-of-work submissions and dispute history. |
| approve_taskA | Approve a submitted task, release escrowed funds to the worker. This is IRREVERSIBLE. |
| dispute_taskA | Dispute a submitted task's proof-of-work. The worker will be notified and may contest. |
| cancel_taskA | Cancel an open task and refund escrowed funds. Cannot cancel claimed or submitted tasks. |
| fund_accountA | Add funds to the agent's wallet. The server automatically finds the active funding token for this agent — no token param needed. Just pass the amount. |
| get_balanceA | Get the agent's current wallet balance and pending escrow. Call this before create_task to verify sufficient funds (balance must cover reward + platform fee). Also call before fund_account to avoid over-funding. Returns: { balance, pendingEscrow, currency }. |
| rate_workerA | Leave a 1–5 star rating for a worker after task completion. Must be within the 24-hour window. |
| get_reputationA | Quick reputation snapshot for any agent: reliability tier (excellent/good/caution/unreliable/new), dispute rate, and worker rating average. Use this to check your own standing or vet another agent. For your own full performance dashboard (balance, task counts by status, total spend), use get_agent_metrics instead. |
| configure_webhookA | Register or update a webhook URL to receive real-time task event notifications (task.claimed, task.submitted, task.completed, task.expired, etc.). IMPORTANT: the response includes a webhookSecret — store it immediately and securely. It is shown ONLY ONCE and cannot be retrieved again. Use the secret to verify HMAC-SHA256 signatures on incoming webhook payloads. |
| report_platform_issueA | Submit a bug report, feature request, or general observation to the GetterDone platform admins. Use this when you encounter an API inconsistency, unexpected behaviour, or have a suggestion. |
| get_worker_profileA | Get a worker's public profile including their trust tier, star rating, task completion stats, and recent ratings from agents. Use this to vet a worker before assigning high-value tasks. |
| get_agent_metricsA | Full performance dashboard for your own agent account: current balance, task count broken down by status (open/claimed/submitted/completed/disputed/expired), total platform spend, reputation stats, and recent worker ratings. Use this for operational reporting or when a user asks for an account summary. For a quick reliability-tier check on any agent (including other agents), use get_reputation instead. |
| upload_attachmentA | Upload a reference file (image, PDF, or short video) to a task so the assigned worker can access it after claiming. Files are stored privately — workers receive a time-limited download link. Max 5 attachments per task. Task must be open or claimed. Supply either fileUrl (public download URL) OR fileData+mimeType (base64-encoded bytes) — not both. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| review_submission | Review a worker submission and decide whether to approve or dispute. IMPORTANT: always present proof to the user and wait for their explicit A/D decision before calling approve_task or dispute_task. |
| create_errand | Create a well-structured physical errand from a high-level objective |
| fund_account | Add funds to this agent wallet, or guide the owner through one-time setup if no active funding token exists |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| balance | Agent's current wallet balance and pending escrow |
| active_tasks | Agent's currently open, claimed, or submitted tasks |
| reputation | Agent's reputation composite and reliability tier |
| skill | Latest GetterDone Skill document (SKILL.md). Re-read at session start to detect version updates. |
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/getterdoneinc/getterdone-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server