@getterdone/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 maociao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# @getterdone/mcp-server
+
+MCP server that connects AI agents to the [GetterDone](https://getterdone.mellowcake.ai) physical-task marketplace. Expose task creation, approval, disputes, funding, and reputation as native tools in Claude Desktop, Cursor, and any MCP-compatible host.
+
+## Quick Start
+
+```bash
+# Install
+npm install @getterdone/mcp-server
+
+# Register your agent (one-time setup)
+npx getterdone-mcp setup --name "MyAgent"
+
+# Start the server
+npx getterdone-mcp
+```
+
+## Setup
+
+The `setup` command handles everything automatically:
+
+1. Fetches a proof-of-work challenge from the API
+2. Solves the SHA-256 challenge (~1–4 seconds)
+3. Registers your agent and receives credentials
+4. Saves credentials to `~/.getterdone/credentials.json` (mode `0600`)
+
+```bash
+# Against production
+npx getterdone-mcp setup --name "MyAgent"
+
+# Against a local dev server
+GETTERDONE_API_URL=http://localhost:3001 npx getterdone-mcp setup --name "DevAgent"
+
+# Custom credentials path
+npx getterdone-mcp setup --name "MyAgent" --creds ./my-creds.json
+```
+
+> ⚠️ The `clientSecret` is shown **only once** at registration. The setup command stores it automatically — don't lose the credentials file.
+
+## Host Configuration
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "getterdone": {
+      "command": "npx",
+      "args": ["-y", "@getterdone/mcp-server"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "getterdone": {
+      "command": "npx",
+      "args": ["-y", "@getterdone/mcp-server"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `create_task` | Post a task to the marketplace (funds auto-escrowed) |
+| `list_tasks` | List your tasks, optionally filtered by status |
+| `get_task` | Get full task details including proof and disputes |
+| `approve_task` | Approve submission and release funds (**irreversible**) |
+| `dispute_task` | Dispute a submission with a reason |
+| `cancel_task` | Cancel an open task and refund escrow |
+| `fund_account` | Add funds to your wallet |
+| `get_balance` | Check your current balance |
+| `rate_worker` | Rate a worker 1–5 stars (24h window) |
+| `get_reputation` | Get reputation composite and reliability tier |
+| `configure_webhook` | Set a webhook URL for real-time events |
+
+## Resources
+
+| URI | Description |
+|---|---|
+| `getterdone://balance` | Current wallet balance and pending escrow |
+| `getterdone://tasks/active` | Open, claimed, and submitted tasks |
+| `getterdone://reputation` | Reputation composite and reliability tier |
+
+## Prompts
+
+| Prompt | Description |
+|---|---|
+| `review_submission` | Guided workflow to review a worker's proof and approve/dispute |
+| `create_errand` | Structured task creation from a high-level objective |
+
+## Environment Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `GETTERDONE_API_URL` | `https://getterdone.ai` | API base URL |
+| `GETTERDONE_CLIENT_ID` | — | Override client ID (skip credentials file) |
+| `GETTERDONE_CLIENT_SECRET` | — | Override client secret (skip credentials file) |
+| `GETTERDONE_CREDENTIALS_PATH` | `~/.getterdone/credentials.json` | Credentials file path |
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Test CLI
+node dist/cli.js --help
+```
+
+## Architecture
+
+```
+src/
+├── cli.ts                    # CLI entry point (setup + server start)
+├── index.ts                  # Main server wiring
+├── credentials.ts            # Credential load/save
+├── api-client.ts             # HTTP client with retry logic
+├── auth.ts                   # PoW solver + token lifecycle
+├── tools.ts                  # 11 MCP tool registrations
+└── resources-and-prompts.ts  # 3 resources + 2 prompt templates
+```
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,91 @@
+/**
+ * HTTP client wrapping the GetterDone REST API.
+ *
+ * Features:
+ *   - Automatic Bearer token injection
+ *   - Retry on 429 (rate limit) and 500 (server error)
+ *   - Structured error translation
+ */
+export interface ApiError {
+    status: number;
+    code: string;
+    message: string;
+}
+export interface ApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+}
+export declare class ApiClient {
+    private baseUrl;
+    private getToken;
+    private retry;
+    constructor(baseUrl: string, getToken: () => Promise<string>, retry?: RetryConfig);
+    private request;
+    getChallenge(): Promise<{
+        challengeId: string;
+        nonce: string;
+        difficulty: number;
+        expiresAt: number;
+    }>;
+    register(body: {
+        name: string;
+        challengeId: string;
+        solution: string;
+        timing: number;
+        environment: string;
+    }): Promise<{
+        agent: {
+            id: string;
+            name: string;
+        };
+        clientId: string;
+        clientSecret: string;
+    }>;
+    getTokenRaw(body: {
+        client_id: string;
+        client_secret: string;
+        grant_type: 'client_credentials';
+    }): Promise<{
+        access_token: string;
+        token_type: string;
+        expires_in: number;
+    }>;
+    createTask(body: {
+        title: string;
+        description: string;
+        reward: number;
+        category?: string;
+        location: {
+            lat: number;
+            lng: number;
+            label: string;
+            remote?: boolean;
+        };
+        expiresInHours?: number;
+        reviewCriteria?: {
+            keywords?: string[];
+            minImages?: number;
+        };
+    }): Promise<unknown>;
+    listTasks(params?: {
+        status?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    getTask(taskId: string): Promise<unknown>;
+    approveTask(taskId: string): Promise<unknown>;
+    disputeTask(taskId: string, reason: string): Promise<unknown>;
+    cancelTask(taskId: string): Promise<unknown>;
+    fundAccount(amount: number, paymentMethodNonce?: string): Promise<unknown>;
+    getBalance(): Promise<unknown>;
+    rateWorker(taskId: string, score: number, comment?: string): Promise<unknown>;
+    getReputation(agentId?: string): Promise<unknown>;
+    configureWebhook(url: string): Promise<unknown>;
+    getWebhookConfig(): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/api-client.js

@@ -0,0 +1,170 @@
+/**
+ * HTTP client wrapping the GetterDone REST API.
+ *
+ * Features:
+ *   - Automatic Bearer token injection
+ *   - Retry on 429 (rate limit) and 500 (server error)
+ *   - Structured error translation
+ */
+// ── Error Codes ──────────────────────────────────────────
+const STATUS_TO_CODE = {
+    400: 'bad_request',
+    401: 'unauthorized',
+    402: 'insufficient_balance',
+    403: 'forbidden',
+    404: 'not_found',
+    409: 'conflict',
+    410: 'window_closed',
+    429: 'rate_limited',
+    500: 'server_error',
+};
+// ── Client ───────────────────────────────────────────────
+export class ApiClient {
+    baseUrl;
+    getToken;
+    retry;
+    constructor(baseUrl, getToken, retry = { maxRetries: 2, baseDelayMs: 1000 }) {
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.getToken = getToken;
+        this.retry = retry;
+    }
+    // ── Generic request ──────────────────────────────────
+    async request(method, path, body, requireAuth = true) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.retry.maxRetries; attempt++) {
+            const headers = {
+                'Content-Type': 'application/json',
+                'User-Agent': '@getterdone/mcp-server',
+            };
+            if (requireAuth) {
+                headers['Authorization'] = `Bearer ${await this.getToken()}`;
+            }
+            const res = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            // Success
+            if (res.ok) {
+                const json = await res.json();
+                return json.data;
+            }
+            // Parse error
+            let errorMessage;
+            try {
+                const errorJson = await res.json();
+                errorMessage = errorJson.error ?? `HTTP ${res.status}`;
+            }
+            catch {
+                errorMessage = `HTTP ${res.status} ${res.statusText}`;
+            }
+            lastError = {
+                status: res.status,
+                code: STATUS_TO_CODE[res.status] ?? 'unknown',
+                message: errorMessage,
+            };
+            // Retry on 429 or 500
+            if ((res.status === 429 || res.status === 500) && attempt < this.retry.maxRetries) {
+                const retryAfter = res.headers.get('Retry-After');
+                const delayMs = retryAfter
+                    ? parseInt(retryAfter, 10) * 1000
+                    : this.retry.baseDelayMs * Math.pow(2, attempt) + Math.random() * 500;
+                await sleep(delayMs);
+                continue;
+            }
+            // Non-retryable error
+            break;
+        }
+        throw lastError;
+    }
+    // ── Auth (no Bearer required) ────────────────────────
+    async getChallenge() {
+        return this.request('GET', '/api/auth/agent/challenge', undefined, false);
+    }
+    async register(body) {
+        return this.request('POST', '/api/auth/agent/register', body, false);
+    }
+    async getTokenRaw(body) {
+        // Token endpoint returns a different shape (OAuth2), handle directly
+        const res = await fetch(`${this.baseUrl}/api/auth/agent/token`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': '@getterdone/mcp-server',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            let msg;
+            try {
+                const err = await res.json();
+                msg = err.error_description ?? err.error ?? `HTTP ${res.status}`;
+            }
+            catch {
+                msg = `HTTP ${res.status}`;
+            }
+            throw { status: res.status, code: 'unauthorized', message: msg };
+        }
+        return res.json();
+    }
+    // ── Tasks ────────────────────────────────────────────
+    async createTask(body) {
+        return this.request('POST', '/api/tasks', body);
+    }
+    async listTasks(params = {}) {
+        const qs = new URLSearchParams();
+        if (params.status && params.status !== 'all')
+            qs.set('status', params.status);
+        if (params.limit)
+            qs.set('limit', String(params.limit));
+        const query = qs.toString();
+        return this.request('GET', `/api/tasks${query ? '?' + query : ''}`);
+    }
+    async getTask(taskId) {
+        return this.request('GET', `/api/tasks/${taskId}`);
+    }
+    async approveTask(taskId) {
+        return this.request('POST', `/api/tasks/${taskId}/complete`);
+    }
+    async disputeTask(taskId, reason) {
+        return this.request('POST', `/api/tasks/${taskId}/dispute`, { reason });
+    }
+    async cancelTask(taskId) {
+        return this.request('POST', `/api/tasks/${taskId}/cancel`);
+    }
+    // ── Account ──────────────────────────────────────────
+    async fundAccount(amount, paymentMethodNonce) {
+        return this.request('POST', '/api/agents/fund', { amount, paymentMethodNonce });
+    }
+    async getBalance() {
+        return this.request('GET', '/api/agents/balance');
+    }
+    // ── Ratings & Reputation ─────────────────────────────
+    async rateWorker(taskId, score, comment) {
+        return this.request('POST', `/api/tasks/${taskId}/rate`, { score, comment });
+    }
+    async getReputation(agentId) {
+        if (!agentId) {
+            // Fallback: the server should infer from token, but we need the ID
+            // Return an error hint — caller should supply the ID from credentials
+            throw {
+                status: 400,
+                code: 'bad_request',
+                message: 'agentId is required for reputation lookup',
+            };
+        }
+        return this.request('GET', `/api/agents/${agentId}/reputation`, undefined, false);
+    }
+    // ── Webhooks ─────────────────────────────────────────
+    async configureWebhook(url) {
+        return this.request('POST', '/api/agents/webhooks', { url });
+    }
+    async getWebhookConfig() {
+        return this.request('GET', '/api/agents/webhooks');
+    }
+}
+// ── Helpers ──────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/auth.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Authentication lifecycle:
+ *   - SHA-256 Proof-of-Work solver
+ *   - TokenManager with auto-refresh
+ *   - Full setupAgent() registration flow
+ */
+import { ApiClient } from './api-client.js';
+import { type Credentials } from './credentials.js';
+/**
+ * Solve a SHA-256 proof-of-work challenge.
+ *
+ * Finds a hex string `candidate` such that
+ * SHA-256(nonce + candidate) has ≥ difficulty leading zero bits.
+ */
+export declare function solveChallenge(nonce: string, difficulty: number): {
+    solution: string;
+    iterations: number;
+    durationMs: number;
+};
+export declare class TokenManager {
+    private clientId;
+    private clientSecret;
+    private apiClient;
+    private currentToken;
+    private expiresAt;
+    private refreshBuffer;
+    constructor(clientId: string, clientSecret: string, apiClient: ApiClient);
+    /**
+     * Get a valid access token, refreshing if needed.
+     */
+    getToken(): Promise<string>;
+}
+export interface SetupResult {
+    credentials: Credentials;
+    savedTo: string;
+}
+/**
+ * Full agent registration flow:
+ *   1. Get challenge from API
+ *   2. Solve SHA-256 PoW
+ *   3. Register agent
+ *   4. Persist credentials to disk
+ */
+export declare function setupAgent(name: string, apiUrl: string, credentialsPath?: string, log?: (msg: string) => void): Promise<SetupResult>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAqBrE;;;;;GAKG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAe9D;AAID,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAkB;gBAE3B,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS;IAMxE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAgBpC;AAID,MAAM,WAAW,WAAW;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EACxB,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAoB,GAC3C,OAAO,CAAC,WAAW,CAAC,CA8CtB"}

package/dist/auth.js

@@ -0,0 +1,125 @@
+/**
+ * Authentication lifecycle:
+ *   - SHA-256 Proof-of-Work solver
+ *   - TokenManager with auto-refresh
+ *   - Full setupAgent() registration flow
+ */
+import { createHash } from 'node:crypto';
+import { ApiClient } from './api-client.js';
+import { saveCredentials } from './credentials.js';
+// ── PoW Solver ───────────────────────────────────────────
+/**
+ * Check if a buffer has at least `bits` leading zero bits.
+ */
+function hasLeadingZeroBits(buf, bits) {
+    const fullBytes = Math.floor(bits / 8);
+    const remainingBits = bits % 8;
+    for (let i = 0; i < fullBytes; i++) {
+        if (buf[i] !== 0)
+            return false;
+    }
+    if (remainingBits > 0) {
+        const mask = 0xff << (8 - remainingBits);
+        if ((buf[fullBytes] & mask) !== 0)
+            return false;
+    }
+    return true;
+}
+/**
+ * Solve a SHA-256 proof-of-work challenge.
+ *
+ * Finds a hex string `candidate` such that
+ * SHA-256(nonce + candidate) has ≥ difficulty leading zero bits.
+ */
+export function solveChallenge(nonce, difficulty) {
+    const start = Date.now();
+    for (let i = 0;; i++) {
+        const candidate = i.toString(16);
+        const hash = createHash('sha256').update(nonce + candidate).digest();
+        if (hasLeadingZeroBits(hash, difficulty)) {
+            return {
+                solution: candidate,
+                iterations: i + 1,
+                durationMs: Date.now() - start,
+            };
+        }
+    }
+}
+// ── Token Manager ────────────────────────────────────────
+export class TokenManager {
+    clientId;
+    clientSecret;
+    apiClient;
+    currentToken = null;
+    expiresAt = 0; // unix ms
+    refreshBuffer = 10 * 60 * 1000; // refresh 10 min before expiry
+    constructor(clientId, clientSecret, apiClient) {
+        this.clientId = clientId;
+        this.clientSecret = clientSecret;
+        this.apiClient = apiClient;
+    }
+    /**
+     * Get a valid access token, refreshing if needed.
+     */
+    async getToken() {
+        if (this.currentToken && Date.now() < this.expiresAt - this.refreshBuffer) {
+            return this.currentToken;
+        }
+        const result = await this.apiClient.getTokenRaw({
+            client_id: this.clientId,
+            client_secret: this.clientSecret,
+            grant_type: 'client_credentials',
+        });
+        this.currentToken = result.access_token;
+        this.expiresAt = Date.now() + result.expires_in * 1000;
+        return this.currentToken;
+    }
+}
+/**
+ * Full agent registration flow:
+ *   1. Get challenge from API
+ *   2. Solve SHA-256 PoW
+ *   3. Register agent
+ *   4. Persist credentials to disk
+ */
+export async function setupAgent(name, apiUrl, credentialsPath, log = console.error) {
+    // Create an unauthenticated API client for registration
+    const api = new ApiClient(apiUrl, async () => '');
+    // 1. Get challenge
+    log('🔑 Getting challenge...');
+    const challenge = await api.getChallenge();
+    log(`   Challenge ID: ${challenge.challengeId}`);
+    log(`   Difficulty: ${challenge.difficulty} bits (~${2 ** challenge.difficulty} iterations)`);
+    // 2. Solve PoW
+    log('⚙️  Solving proof-of-work...');
+    const { solution, iterations, durationMs } = solveChallenge(challenge.nonce, challenge.difficulty);
+    log(`   ✅ Solved in ${iterations.toLocaleString()} iterations (${durationMs}ms)`);
+    // 3. Register
+    log('📝 Registering agent...');
+    const result = await api.register({
+        name,
+        challengeId: challenge.challengeId,
+        solution,
+        timing: durationMs,
+        environment: `node:${process.versions.node.split('.')[0]}`,
+    });
+    log(`   ✅ Agent "${result.agent.name}" registered!`);
+    log(`   Agent ID: ${result.agent.id}`);
+    log(`   Client ID: ${result.clientId}`);
+    // 4. Save credentials
+    const credentials = {
+        clientId: result.clientId,
+        clientSecret: result.clientSecret,
+        agentId: result.agent.id,
+        agentName: result.agent.name,
+        apiUrl,
+        registeredAt: new Date().toISOString(),
+    };
+    const savedTo = saveCredentials(credentials, credentialsPath);
+    log(`   💾 Credentials saved to ${savedTo}`);
+    log('');
+    log('⚠️  The clientSecret is shown only once. It has been saved to the file above.');
+    log('   Keep this file safe and do not commit it to version control.');
+    return { credentials, savedTo };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * GetterDone MCP Server — CLI entry point.
+ *
+ * Usage:
+ *   getterdone-mcp setup --name "MyAgent"     # Register + save credentials
+ *   getterdone-mcp                             # Start the MCP server (stdio)
+ *   getterdone-mcp --help                      # Show help
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/cli.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * GetterDone MCP Server — CLI entry point.
+ *
+ * Usage:
+ *   getterdone-mcp setup --name "MyAgent"     # Register + save credentials
+ *   getterdone-mcp                             # Start the MCP server (stdio)
+ *   getterdone-mcp --help                      # Show help
+ */
+import { setupAgent } from './auth.js';
+import { startServer } from './index.js';
+import { defaultCredentialsPath } from './credentials.js';
+const HELP = `
+GetterDone MCP Server — connect AI agents to the physical-task marketplace
+
+USAGE
+  getterdone-mcp                        Start the MCP server (stdio transport)
+  getterdone-mcp setup --name <name>    Register a new agent and save credentials
+  getterdone-mcp --help                 Show this help message
+
+SETUP OPTIONS
+  --name <name>     Agent display name (required)
+  --api-url <url>   API base URL (default: https://getterdone.ai)
+  --creds <path>    Credentials file path (default: ~/.getterdone/credentials.json)
+
+ENVIRONMENT VARIABLES
+  GETTERDONE_API_URL          Override API base URL
+  GETTERDONE_CLIENT_ID        Override client ID (skip credentials file)
+  GETTERDONE_CLIENT_SECRET    Override client secret (skip credentials file)
+  GETTERDONE_CREDENTIALS_PATH Override credentials file path
+
+EXAMPLES
+  # First-time setup
+  getterdone-mcp setup --name "MyAssistant"
+
+  # Start with custom API URL (e.g. local dev)
+  GETTERDONE_API_URL=http://localhost:3001 getterdone-mcp
+
+  # Claude Desktop config (mcp_servers.json)
+  {
+    "mcpServers": {
+      "getterdone": {
+        "command": "npx",
+        "args": ["-y", "@getterdone/mcp-server"]
+      }
+    }
+  }
+`.trim();
+async function main() {
+    const args = process.argv.slice(2);
+    // --help
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    // setup subcommand
+    if (args[0] === 'setup') {
+        const nameIdx = args.indexOf('--name');
+        const name = nameIdx !== -1 ? args[nameIdx + 1] : undefined;
+        if (!name) {
+            console.error('Error: --name <agent-name> is required for setup');
+            console.error('Example: getterdone-mcp setup --name "MyAgent"');
+            process.exit(1);
+        }
+        const apiUrlIdx = args.indexOf('--api-url');
+        const apiUrl = apiUrlIdx !== -1
+            ? args[apiUrlIdx + 1]
+            : (process.env.GETTERDONE_API_URL ?? 'https://getterdone.ai');
+        const credsIdx = args.indexOf('--creds');
+        const credsPath = credsIdx !== -1 ? args[credsIdx + 1] : undefined;
+        try {
+            console.error('');
+            console.error('🚀 GetterDone Agent Setup');
+            console.error('========================');
+            console.error(`   API URL: ${apiUrl}`);
+            console.error(`   Credentials: ${credsPath ?? defaultCredentialsPath()}`);
+            console.error('');
+            await setupAgent(name, apiUrl, credsPath);
+            console.error('');
+            console.error('✅ Setup complete! You can now start the MCP server:');
+            console.error('   getterdone-mcp');
+            console.error('');
+        }
+        catch (err) {
+            console.error('');
+            console.error('❌ Setup failed:', err instanceof Error ? err.message : err);
+            process.exit(1);
+        }
+        return;
+    }
+    // Default: start the MCP server
+    try {
+        await startServer();
+    }
+    catch (err) {
+        console.error('Fatal error:', err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/credentials.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Credential persistence — load / save agent credentials to disk.
+ *
+ * Default path: ~/.getterdone/credentials.json
+ * Env-var overrides: GETTERDONE_CLIENT_ID, GETTERDONE_CLIENT_SECRET
+ */
+export interface Credentials {
+    clientId: string;
+    clientSecret: string;
+    agentId: string;
+    agentName: string;
+    apiUrl: string;
+    registeredAt: string;
+}
+export declare function defaultCredentialsPath(): string;
+/**
+ * Load credentials from env vars first, then fall back to disk.
+ * Throws if neither source provides valid credentials.
+ */
+export declare function loadCredentials(path?: string): Credentials;
+/**
+ * Persist credentials to disk with restrictive permissions (0600).
+ */
+export declare function saveCredentials(creds: Credentials, path?: string): string;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACxB;AAID,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CA6C1D;AAID;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAazE"}

package/dist/credentials.js

@@ -0,0 +1,74 @@
+/**
+ * Credential persistence — load / save agent credentials to disk.
+ *
+ * Default path: ~/.getterdone/credentials.json
+ * Env-var overrides: GETTERDONE_CLIENT_ID, GETTERDONE_CLIENT_SECRET
+ */
+import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+// ── Paths ────────────────────────────────────────────────
+export function defaultCredentialsPath() {
+    return process.env.GETTERDONE_CREDENTIALS_PATH
+        ?? join(homedir(), '.getterdone', 'credentials.json');
+}
+// ── Load ─────────────────────────────────────────────────
+/**
+ * Load credentials from env vars first, then fall back to disk.
+ * Throws if neither source provides valid credentials.
+ */
+export function loadCredentials(path) {
+    // 1. Try env vars
+    const envId = process.env.GETTERDONE_CLIENT_ID;
+    const envSecret = process.env.GETTERDONE_CLIENT_SECRET;
+    if (envId && envSecret) {
+        return {
+            clientId: envId,
+            clientSecret: envSecret,
+            agentId: '',
+            agentName: '',
+            apiUrl: process.env.GETTERDONE_API_URL ?? 'https://getterdone.ai',
+            registeredAt: '',
+        };
+    }
+    // 2. Try credentials file
+    const filePath = path ?? defaultCredentialsPath();
+    if (!existsSync(filePath)) {
+        throw new Error(`No credentials found. Run "getterdone-mcp setup --name <agent>" first, ` +
+            `or set GETTERDONE_CLIENT_ID and GETTERDONE_CLIENT_SECRET env vars.`);
+    }
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        const creds = JSON.parse(raw);
+        if (!creds.clientId || !creds.clientSecret) {
+            throw new Error('Credentials file is missing clientId or clientSecret');
+        }
+        // Allow env override of API URL even when reading from file
+        if (process.env.GETTERDONE_API_URL) {
+            creds.apiUrl = process.env.GETTERDONE_API_URL;
+        }
+        return creds;
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            throw new Error(`Invalid credentials file at ${filePath}: ${err.message}`);
+        }
+        throw err;
+    }
+}
+// ── Save ─────────────────────────────────────────────────
+/**
+ * Persist credentials to disk with restrictive permissions (0600).
+ */
+export function saveCredentials(creds, path) {
+    const filePath = path ?? defaultCredentialsPath();
+    const dir = dirname(filePath);
+    // Create directory if needed
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    writeFileSync(filePath, JSON.stringify(creds, null, 2) + '\n', 'utf-8');
+    chmodSync(filePath, 0o600);
+    return filePath;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAa1C,4DAA4D;AAE5D,MAAM,UAAU,sBAAsB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,2BAA2B;WACvC,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAC9D,CAAC;AAED,4DAA4D;AAE5D;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IACzC,kBAAkB;IAClB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAEvD,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;QACrB,OAAO;YACH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,SAAS;YACvB,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,uBAAuB;YACjE,YAAY,EAAE,EAAE;SACnB,CAAC;IACN,CAAC;IAED,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,IAAI,IAAI,sBAAsB,EAAE,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACX,yEAAyE;YACzE,oEAAoE,CACvE,CAAC;IACN,CAAC;IAED,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;QAE7C,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC5E,CAAC;QAED,4DAA4D;QAC5D,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;YACjC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAClD,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,GAAG,CAAC;IACd,CAAC;AACL,CAAC;AAED,4DAA4D;AAE5D;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAkB,EAAE,IAAa;IAC7D,MAAM,QAAQ,GAAG,IAAI,IAAI,sBAAsB,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE9B,6BAA6B;IAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACxE,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAE3B,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GetterDone MCP Server — main entry point.
+ *
+ * Wires credentials → auth → API client → tools/resources/prompts,
+ * then connects via stdio transport.
+ */
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAmCjD"}

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * GetterDone MCP Server — main entry point.
+ *
+ * Wires credentials → auth → API client → tools/resources/prompts,
+ * then connects via stdio transport.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadCredentials } from './credentials.js';
+import { ApiClient } from './api-client.js';
+import { TokenManager } from './auth.js';
+import { registerTools } from './tools.js';
+import { registerResources, registerPrompts } from './resources-and-prompts.js';
+export async function startServer() {
+    // 1. Load credentials
+    const creds = loadCredentials();
+    // 2. Create server
+    const server = new McpServer({
+        name: 'getterdone',
+        version: '0.1.0',
+    });
+    // 3. Create API client with token manager
+    //    We need a circular dependency: ApiClient needs getToken, TokenManager needs ApiClient.
+    //    Solve by creating ApiClient first with a placeholder, then wiring up.
+    let tokenManager;
+    const api = new ApiClient(creds.apiUrl, async () => tokenManager.getToken());
+    tokenManager = new TokenManager(creds.clientId, creds.clientSecret, api);
+    // 4. Register tools, resources, and prompts
+    registerTools(server, api, creds.agentId);
+    registerResources(server, api, creds.agentId);
+    registerPrompts(server);
+    // 5. Connect via stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is reserved for MCP protocol)
+    console.error('🚀 GetterDone MCP Server running on stdio');
+    console.error(`   Agent: ${creds.agentName || creds.clientId}`);
+    console.error(`   API:   ${creds.apiUrl}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEhF,MAAM,CAAC,KAAK,UAAU,WAAW;IAC7B,sBAAsB;IACtB,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAEhC,mBAAmB;IACnB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QACzB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,0CAA0C;IAC1C,4FAA4F;IAC5F,2EAA2E;IAC3E,IAAI,YAA0B,CAAC;IAE/B,MAAM,GAAG,GAAG,IAAI,SAAS,CACrB,KAAK,CAAC,MAAM,EACZ,KAAK,IAAI,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,CACtC,CAAC;IAEF,YAAY,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAEzE,4CAA4C;IAC5C,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1C,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,uBAAuB;IACvB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,sDAAsD;IACtD,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC3D,OAAO,CAAC,KAAK,CAAC,aAAa,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,KAAK,CAAC,aAAa,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/resources-and-prompts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP resources and prompt templates.
+ *
+ * Resources: getterdone://balance, getterdone://tasks/active, getterdone://reputation
+ * Prompts:   review_submission, create_errand
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ApiClient } from './api-client.js';
+export declare function registerResources(server: McpServer, api: ApiClient, agentId: string): void;
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=resources-and-prompts.d.ts.map

package/dist/resources-and-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources-and-prompts.d.ts","sourceRoot":"","sources":["../src/resources-and-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAkF1F;AAID,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4DvD"}

package/dist/resources-and-prompts.js

@@ -0,0 +1,127 @@
+/**
+ * MCP resources and prompt templates.
+ *
+ * Resources: getterdone://balance, getterdone://tasks/active, getterdone://reputation
+ * Prompts:   review_submission, create_errand
+ */
+import { z } from 'zod';
+// ── Resources ────────────────────────────────────────────
+export function registerResources(server, api, agentId) {
+    // Balance
+    server.resource('balance', 'getterdone://balance', { description: "Agent's current wallet balance and pending escrow" }, async () => {
+        try {
+            const data = await api.getBalance();
+            return {
+                contents: [{
+                        uri: 'getterdone://balance',
+                        mimeType: 'application/json',
+                        text: JSON.stringify(data, null, 2),
+                    }],
+            };
+        }
+        catch {
+            return {
+                contents: [{
+                        uri: 'getterdone://balance',
+                        mimeType: 'application/json',
+                        text: '{"error": "Failed to fetch balance"}',
+                    }],
+            };
+        }
+    });
+    // Active tasks
+    server.resource('active_tasks', 'getterdone://tasks/active', { description: "Agent's currently open, claimed, or submitted tasks" }, async () => {
+        try {
+            const data = await api.listTasks({ status: 'open,claimed,submitted' });
+            return {
+                contents: [{
+                        uri: 'getterdone://tasks/active',
+                        mimeType: 'application/json',
+                        text: JSON.stringify(data, null, 2),
+                    }],
+            };
+        }
+        catch {
+            return {
+                contents: [{
+                        uri: 'getterdone://tasks/active',
+                        mimeType: 'application/json',
+                        text: '{"error": "Failed to fetch active tasks"}',
+                    }],
+            };
+        }
+    });
+    // Reputation
+    server.resource('reputation', 'getterdone://reputation', { description: "Agent's reputation composite and reliability tier" }, async () => {
+        try {
+            const data = await api.getReputation(agentId);
+            return {
+                contents: [{
+                        uri: 'getterdone://reputation',
+                        mimeType: 'application/json',
+                        text: JSON.stringify(data, null, 2),
+                    }],
+            };
+        }
+        catch {
+            return {
+                contents: [{
+                        uri: 'getterdone://reputation',
+                        mimeType: 'application/json',
+                        text: '{"error": "Failed to fetch reputation"}',
+                    }],
+            };
+        }
+    });
+}
+// ── Prompts ──────────────────────────────────────────────
+export function registerPrompts(server) {
+    // review_submission — guide agent through reviewing a worker's proof
+    server.prompt('review_submission', 'Review a worker submission and decide whether to approve or dispute', { taskId: z.string().describe('The task ID to review') }, async ({ taskId }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        `Please review the submission for task ${taskId}.`,
+                        '',
+                        'Steps:',
+                        `1. First, call the \`get_task\` tool with taskId "${taskId}" to fetch the full task details.`,
+                        '2. Compare the worker\'s proof-of-work against the original task requirements.',
+                        '3. Check if any review criteria (keywords, minimum images) are satisfied.',
+                        '4. Make a decision:',
+                        `   - If the proof satisfies the requirements → call \`approve_task\` with taskId "${taskId}"`,
+                        `   - If the proof is insufficient → call \`dispute_task\` with taskId "${taskId}" and a detailed reason (min 10 chars)`,
+                        '',
+                        'Important: Approving is IRREVERSIBLE and releases the escrowed funds to the worker.',
+                        'When in doubt, ask me for clarification before approving.',
+                    ].join('\n'),
+                },
+            }],
+    }));
+    // create_errand — guide agent through structured task creation
+    server.prompt('create_errand', 'Create a well-structured physical errand from a high-level objective', { objective: z.string().describe("What the agent wants accomplished (e.g., 'verify business hours of Joe's Pizza')") }, async ({ objective }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        `I want to create a GetterDone task from this objective: "${objective}"`,
+                        '',
+                        'Please help me structure this into a well-defined task:',
+                        '',
+                        '1. **Title** — A short, clear summary (< 80 chars)',
+                        '2. **Description** — Step-by-step instructions for the worker',
+                        '3. **Location** — Where the task needs to happen (lat, lng, label)',
+                        '4. **Reward** — Fair compensation ($1–$100)',
+                        '5. **Category** — General, Delivery, Photography, Research, or Physical Task',
+                        '6. **Review Criteria** — Keywords and minimum images to verify completion',
+                        '',
+                        'Once you have all the details, call `create_task` with the structured payload.',
+                        'If the objective is location-independent, set remote to true.',
+                    ].join('\n'),
+                },
+            }],
+    }));
+}
+//# sourceMappingURL=resources-and-prompts.js.map

package/dist/resources-and-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources-and-prompts.js","sourceRoot":"","sources":["../src/resources-and-prompts.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Register all 11 MCP tools on the server instance.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ApiClient } from './api-client.js';
+export declare function registerTools(server: McpServer, api: ApiClient, agentId: string): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,iBAAiB,CAAC;AAuC3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAsItF"}

package/dist/tools.js

@@ -0,0 +1,100 @@
+/**
+ * Register all 11 MCP tools on the server instance.
+ */
+import { z } from 'zod';
+// ── Helpers ──────────────────────────────────────────────
+function success(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+function error(err) {
+    const apiErr = err;
+    const message = apiErr?.message
+        ? `[${apiErr.code ?? 'error'}] ${apiErr.message}`
+        : String(err);
+    return {
+        content: [{ type: 'text', text: message }],
+        isError: true,
+    };
+}
+async function wrap(fn) {
+    try {
+        const data = await fn();
+        return success(data);
+    }
+    catch (err) {
+        return error(err);
+    }
+}
+// ── Registration ─────────────────────────────────────────
+export function registerTools(server, api, agentId) {
+    // 1. create_task
+    server.tool('create_task', "Post a new task to the GetterDone marketplace. Funds are automatically escrowed from the agent's balance.", {
+        title: z.string().describe("Short title (e.g., 'Buy coffee at Starbucks on 5th Ave')"),
+        description: z.string().describe('Detailed instructions for the worker'),
+        reward: z.number().min(1).max(100).describe('USD amount to pay the worker ($1–$100)'),
+        category: z.enum(['General', 'Delivery', 'Photography', 'Research', 'Physical Task']).default('General').describe('Task category'),
+        lat: z.number().describe('Location latitude'),
+        lng: z.number().describe('Location longitude'),
+        locationLabel: z.string().describe('Human-readable address'),
+        remote: z.boolean().default(false).describe('Set true for location-independent tasks'),
+        expiresInHours: z.number().default(24).describe('Hours until auto-expiry if unclaimed'),
+        keywords: z.array(z.string()).optional().describe('Keywords required in worker proof'),
+        minImages: z.number().optional().describe('Minimum images required in worker proof'),
+    }, async (args) => wrap(() => api.createTask({
+        title: args.title,
+        description: args.description,
+        reward: args.reward,
+        category: args.category,
+        location: { lat: args.lat, lng: args.lng, label: args.locationLabel, remote: args.remote },
+        expiresInHours: args.expiresInHours,
+        reviewCriteria: (args.keywords || args.minImages)
+            ? { keywords: args.keywords, minImages: args.minImages }
+            : undefined,
+    })));
+    // 2. list_tasks
+    server.tool('list_tasks', "List the agent's own tasks, optionally filtered by status.", {
+        status: z.enum(['open', 'claimed', 'submitted', 'completed', 'disputed', 'contested', 'expired', 'all']).default('all').describe('Filter by status'),
+        limit: z.number().min(1).max(50).default(20).describe('Max results'),
+    }, async (args) => wrap(() => api.listTasks({ status: args.status, limit: args.limit })));
+    // 3. get_task
+    server.tool('get_task', 'Get full details for a specific task, including proof-of-work submissions and dispute history.', {
+        taskId: z.string().describe('The unique task ID'),
+    }, async (args) => wrap(() => api.getTask(args.taskId)));
+    // 4. approve_task
+    server.tool('approve_task', 'Approve a submitted task, release escrowed funds to the worker. This is IRREVERSIBLE.', {
+        taskId: z.string().describe('The task ID to approve'),
+    }, async (args) => wrap(() => api.approveTask(args.taskId)));
+    // 5. dispute_task
+    server.tool('dispute_task', "Dispute a submitted task's proof-of-work. The worker will be notified and may contest.", {
+        taskId: z.string().describe('The task ID to dispute'),
+        reason: z.string().min(10).describe('Detailed reason why the proof is insufficient (min 10 chars)'),
+    }, async (args) => wrap(() => api.disputeTask(args.taskId, args.reason)));
+    // 6. cancel_task
+    server.tool('cancel_task', 'Cancel an open task and refund escrowed funds. Cannot cancel claimed or submitted tasks.', {
+        taskId: z.string().describe('The task ID to cancel'),
+    }, async (args) => wrap(() => api.cancelTask(args.taskId)));
+    // 7. fund_account
+    server.tool('fund_account', "Add funds to the agent's wallet.", {
+        amount: z.number().min(1).describe('USD amount to add (minimum $1.00)'),
+        paymentMethodNonce: z.string().optional().describe('Braintree nonce (optional in sandbox)'),
+    }, async (args) => wrap(() => api.fundAccount(args.amount, args.paymentMethodNonce)));
+    // 8. get_balance
+    server.tool('get_balance', "Get the agent's current wallet balance.", {}, async () => wrap(() => api.getBalance()));
+    // 9. rate_worker
+    server.tool('rate_worker', 'Leave a 1–5 star rating for a worker after task completion. Must be within the 24-hour window.', {
+        taskId: z.string().describe('The completed task ID'),
+        score: z.number().int().min(1).max(5).describe('Star rating (1 = poor, 5 = excellent)'),
+        comment: z.string().optional().describe('Optional text feedback'),
+    }, async (args) => wrap(() => api.rateWorker(args.taskId, args.score, args.comment)));
+    // 10. get_reputation
+    server.tool('get_reputation', "Get an agent's reputation composite including completion rate, dispute history, and reliability tier.", {
+        agentId: z.string().optional().describe('Agent ID. Omit to get your own reputation.'),
+    }, async (args) => wrap(() => api.getReputation(args.agentId ?? agentId)));
+    // 11. configure_webhook
+    server.tool('configure_webhook', 'Register or update a webhook URL for real-time event notifications.', {
+        url: z.string().url().describe('HTTPS URL to receive webhook POST requests'),
+    }, async (args) => wrap(() => api.configureWebhook(args.url)));
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+    "name": "@getterdone/mcp-server",
+    "version": "0.1.0",
+    "description": "MCP server for GetterDone — connect AI agents to the physical-task marketplace",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "bin": {
+        "getterdone-mcp": "dist/cli.js"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "start": "node dist/index.js",
+        "setup": "node dist/cli.js setup",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "getterdone",
+        "ai-agent",
+        "marketplace",
+        "claude",
+        "cursor",
+        "llm"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/maociao/getterdone-mcp.git"
+    },
+    "homepage": "https://getterdone.mellowcake.ai",
+    "bugs": {
+        "url": "https://github.com/maociao/getterdone-mcp/issues"
+    },
+    "author": "maociao",
+    "license": "MIT",
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.12.0",
+        "zod": "^3.24.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20",
+        "typescript": "^5"
+    },
+    "engines": {
+        "node": ">=18"
+    }
+}