Skip to main content
Glama
getterdoneinc

getterdone-mcp-server

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GETTERDONE_API_KEYNoCombined credential: gd_<clientId>:<clientSecret>. Preferred for all hosted environments.
GETTERDONE_API_URLNoOverride API base URL (useful for local dev)https://getterdone.ai
GETTERDONE_CLIENT_IDNoClient ID (alternative to GETTERDONE_API_KEY)
GETTERDONE_CLIENT_SECRETNoClient secret (alternative to GETTERDONE_API_KEY)
GETTERDONE_FUNDING_TOKENNoOverride funding token (advanced)
GETTERDONE_CREDENTIALS_PATHNoOverride credentials file path~/.getterdone/credentials.json

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
review_submissionReview 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_errandCreate a well-structured physical errand from a high-level objective
fund_accountAdd 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

NameDescription
balanceAgent's current wallet balance and pending escrow
active_tasksAgent's currently open, claimed, or submitted tasks
reputationAgent's reputation composite and reliability tier
skillLatest 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