Molt2Meet

io.github.molt2meet-orgPublished by GitHub account molt2meet-orgv1.3.0Updated Nov 2, 2026

Dispatch real-world physical tasks to verified human operators. Escrow or direct-settlement.

The publisher's own server: Meet.bot MCP

Overview

AI-generated overview

Molt2Meet lets an assistant dispatch real-world tasks to verified human operators, with proof, escrow or direct settlement, and wallet payments.

What you can do
  • Dispatch, list, inspect, reschedule and cancel physical-world tasks, including proof, GPS stamps and status history
  • Browse service categories and capabilities, signal regional demand, and join country waitlists
  • Fund and check a wallet, run hosted checkout deposits, review transactions and check task funding
  • Approve or reject completed work, acknowledge direct settlements, resolve operator decision requests and add reviews
  • Register agents, create and revoke API keys, manage profiles, webhooks and contact methods
  • File and track support requests, and poll pending actions or task events
When to use it
Useful when an assistant needs something done in the physical world — visiting a location, photographing a sign, verifying opening hours — and needs a paid human operator plus verifiable proof. Also relevant for agents that want to poll task status or receive webhooks about real-world work.
Requirements
Remote streamable HTTP endpoint; no local install. Requires an X-Api-Key header with a key prefixed m2m_, obtained by self-service registration (RegisterAgent tool or the registration endpoint) with no approval step. A funded wallet is needed for escrow tasks; payments go through a hosted checkout. Coverage is per country and limited to currently live countries.
Before you install
The server moves real money: wallet deposits, task payouts, escrow locking, refunds and compensation on cancellation. The API key is shown only once and must be stored securely; keys can be created and revoked. Tasks are dispatched to third-party human operators, who receive the location and task details, and webhooks send task events to an endpoint you configure. Approving, rejecting, cancelling and disputing tasks change task and payment state.

Installation

In SourceWeft

  1. Open Molt2Meet in the dashboard and add it to a workspace.
  2. Connect X-Api-Key credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.molt2meet-org%2Fmolt2meet/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "molt2meet": {
      "type": "http",
      "url": "https://molt.molt2meet.com/mcp",
      "headers": {
        "X-Api-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

Molt2Meet — Examples

[MCP Registry] [Website] [License: MIT]

Integration examples for Molt2Meet — the execution layer for AI agents. Molt2Meet dispatches real-world physical tasks from AI agents to a verified human operator network, with proof, escrow, and webhooks.

Published in the official MCP Registry as io.github.molt2meet-org/molt2meet.

30-second quickstart

bash
# 1. Get an API key (one call, no approval)curl -X POST https://molt.molt2meet.com/api/v1/agents/register \  -H "Content-Type: application/json" \  -d '{"agentName":"My Agent","agentType":"personal_assistant","description":"Demo","acceptedTerms":true}'
# 2. Dispatch a real-world taskcurl -X POST https://molt.molt2meet.com/api/v1/tools/call \  -H "Content-Type: application/json" \  -H "X-Api-Key: m2m_YOUR_KEY" \  -d '{"tool":"DispatchPhysicalTask","arguments":{    "title":"Verify store opening hours",    "description":"Visit the storefront, photograph opening-hours sign, GPS-verify on-location.",    "locationAddress":"Kalverstraat 1, Amsterdam",    "payoutAmount":15,    "payoutCurrency":"EUR"  }}'

That's it. A human operator will accept, execute, and upload proof. You get webhooks (or poll GetPendingActions) for status updates.

Three integration paths

Molt2Meet is the same platform behind three equivalent interfaces — pick what your agent runtime supports:

PathEndpointBest for
MCP (Model Context Protocol)https://molt.molt2meet.com/mcpClaude Desktop, Cursor, Windsurf, VS Code agents
Tool-call bridge (plain HTTP)POST https://molt.molt2meet.com/api/v1/tools/callLangChain, LangGraph, CrewAI, n8n, custom HTTP
REST APIhttps://molt.molt2meet.com/api/v1/*Direct REST clients, OpenAPI codegen

All three expose the same 46 tools (dispatch, funding, proof, settlement, wallet, support) and use the same X-Api-Key auth.

Examples

Language / runtimePath
Python (requests + asyncio)python/
TypeScript (Node, fetch)typescript/
cURL (shell one-liners)curl/
MCP / Claude Desktop (config + setup)mcp/

Each folder has a self-contained README and a working quickstart script.

Self-configuring agents

Both /mcp (for MCP clients) and /.well-known/molt2meet.json (for generic HTTP agents) describe the full platform capabilities in machine-readable form. An agent can fetch either URL, parse the response, and self-configure without reading documentation.

bash
# Universal discovery for non-MCP agentscurl https://molt.molt2meet.com/.well-known/molt2meet.json | jq .tools

Coverage

Molt2Meet operates per-country. Live in: Netherlands, United Kingdom, France, Ireland, United States, Canada, Australia, New Zealand, Hong Kong, India, Estonia. Roadmap: Germany, Belgium, Spain, Italy.

See the live list: https://molt2meet.com/coverage.

Discovery endpoints

Safety & trust

  • Escrow payments — funds locked before work starts, released on proof approval
  • Multi-check proof — GPS radius (Haversine), EXIF geolocation, timestamps, photo count, checklist
  • KYC-verified operators — Stripe Connect Express onboarding
  • GDPR-compliant — RVDH AI-Solution OÜ (Estonia, EU)
  • HMAC-SHA256 signed webhooks — per-agent encrypted secrets
  • Immutable double-entry ledger — every transaction auditable

Contact

License

MIT — see LICENSE.

Source: README.md at commit fb77b96

Tools

54

checkout_wallet_deposit

Checkout Wallet Deposit

Create a hosted checkout session (e.g. Stripe) to deposit funds into your wallet. Returns a checkout URL where you or your user can complete the payment. After successful payment, the wallet is automatically credited. Use this before fund_task if your wallet balance is insufficient. Default currency resolution when omitted: (1) explicit currency honored, (2) single existing wallet used, (3) otherwise the currency of your most recently created task. No stale USD default. Requires authentication.

ParametersamountrequiredapiKeyrequiredlocalecurrencycancelUrlsuccessUrl

get_waitlist_status

Get Waitlist Status

Check your position on the Molt2Meet waitlist, including the country you are waitlisted for (null = global pre-launch waitlist). Requires: API key from register_agent.

ParametersapiKeyrequired

get_wallet_transactions

Get Wallet Transactions

Get your wallet transaction history. Shows all ledger entries with running balance. Optionally filter by task ID. Default currency resolution: (1) explicit currency honored, (2) single existing wallet used, (3) otherwise the currency of your most recently created task. No stale USD default. Requires authentication.

ParametersapiKeyrequiredtaskIdcurrency

check_task_funding

Check Task Funding

ESCROW FLOW ONLY. Direct-settlement tasks never have a PSP payment to check; do not call this on settlementMode='direct' tasks. Check if a PSP payment has been received for a quoted escrow task and automatically fund it. Use this after paying via checkout URL or bank transfer to verify the payment arrived. Syncs with the payment provider and funds the task if sufficient balance is available. Requires authentication.

ParametersapiKeyrequiredtaskIdrequired

create_api_key

Create API Key

Generate a new API key for your agent. The full plaintext key (m2m_...) is returned ONCE — store it securely immediately; it cannot be retrieved later (we only keep its hash). Use keyName to identify the key's purpose (e.g. 'production', 'staging'). Multiple keys can be active simultaneously for zero-downtime rotation. Requires: an existing API key from register_agent. Next: switch your integration to the new key, then revoke_api_key on the old one.

ParametersapiKeyrequiredkeyNamerequired

add_task_review

Add Task Review

Add a review/rating for a completed task. Rate the operator's work quality. This is separate from approve/reject — it records feedback. Requires authentication.

ParametersapiKeyrequiredratingrequiredtaskIdrequiredcommenttagsJsonqualityScoreprofessionalismScore

list_service_interests

List Service Interests

List all your registered service interests. Requires: API key from register_agent.

ParametersapiKeyrequired

add_contact_method

Add Contact Method

Add a notification channel for task status events (operator accepts, uploads proof, etc.). Use methodType 'webhook' with a URL or 'email' with an address. For webhooks: use configJson to configure how Molt2Meet authenticates to YOUR endpoint. Supported authType values: 'header' (sends authValue in authHeader, default Authorization), 'query_param' (appends authQueryParam=authValue to URL), 'basic' (sends authValue as user:pass in Authorization: Basic header). Example configJson for Bearer token: {"authType":"header","authHeader":"Authorization","authValue":"Bearer my-token"}. Example for query param: {"authType":"query_param","authQueryParam":"token","authValue":"my-secret"}. Requires: API key from register_agent. Next: dispatch_physical_task with webhookUrl for per-task events, or use this for account-wide notifications.

ParametersapiKeyrequiredendpointrequiredpriorityconfigJsonmethodTyperequired

list_service_categories

List Service Categories

List available categories of physical-world tasks. Returns category IDs for use with dispatch_physical_task or add_service_interest. Any real-world task can be dispatched even without a category. No authentication required. Next: list_service_capabilities for detailed options, or dispatch_physical_task to dispatch immediately.

Takes no parameters.

list_reschedule_requests

List Reschedule Requests

List all reschedule requests for a task. Shows pending, approved, and rejected requests. Requires authentication.

ParametersapiKeyrequiredtaskIdrequired

cancel_task_with_settlement

Cancel Task With Settlement

Cancel a task with proper financial settlement. Compensation to operator depends on task status (none before acceptance, partial after). Refund to agent for remaining amount. Requires authentication.

ParametersapiKeyrequiredtaskIdrequiredcancellationReasonCodeRefrequired

get_wallet_balance

Get Wallet Balance

Get your wallet balance for a specific currency. Default currency resolution when omitted: (1) if you pass currency explicitly it's honored, (2) if you have exactly one wallet that one is used, (3) otherwise the currency of your most recently created task. No stale USD default. Returns four numbers — understand them before funding a task: totalFunded = lifetime credit ever added to this wallet (gross deposit history). pendingBalance = funds the platform expects from in-flight PSP payments / bank transfers but has not yet confirmed (e.g. checkout in progress, IBAN deposit unreconciled). reservedBalance = funds earmarked for tasks that are quoted but not yet fully funded (soft hold). lockedBalance = funds in escrow for active tasks (Funded → ProofUploaded → UnderReview); released to the operator on approve, refunded on reject/cancel. availableBalance = totalFunded − reservedBalance − lockedBalance − pendingBalance — this is what you can spend on new tasks RIGHT NOW. The response also includes a 'locks' array breaking down lockedBalance into per-task entries (taskId, taskTitle, taskStatus, lockedAmount, lockedAt) so you know exactly which tasks are holding your funds. Use this before fund_task to verify you have sufficient available funds. For all currencies at once, use list_wallets. Requires authentication.

ParametersapiKeyrequiredcurrency

approve_physical_task_completion

Approve Task Completion

Approve a completed task — SIMPLE FLOW ONLY. Precondition: the task was dispatched with publishImmediately=true (default) AND auto-funded from your wallet, i.e. you did NOT call request_task_quote/fund_task/publish_task (escrow flow). If you went through the escrow flow (any of those three tools), call approve_task_review instead — calling this on an escrow task returns an error with the correct tool to use. Mechanism: marks the task Completed and triggers the operator payout immediately. There is no review window for the simple flow. Task must be in ProofUploaded or UnderReview status. Requires: API key from register_agent. Next: monitor task.settled and task.closed via get_task_events — settlement happens automatically.

ParametersapiKeyrequiredtaskIdrequired

get_agent_profile

Get Agent Profile

Retrieve your profile and status. Requires: API key from register_agent.

ParametersapiKeyrequired

fund_wallet

Fund Wallet

Add funds to your wallet via secure payment provider. Returns a checkout URL where you or your user can complete the payment. After successful payment, the wallet is automatically credited. Default currency resolution when omitted: (1) explicit currency honored, (2) single existing wallet used, (3) otherwise the currency of your most recently created task. If none available → error asking you to pass currency explicitly. No stale USD default. Requires authentication.

ParametersamountrequiredapiKeyrequiredlocalecurrencysuccessUrl

get_support_requests

Get Support Requests

List your support requests, complaints, and recommendations. Optionally filter by type or status. Returns request IDs, subjects, statuses, and timestamps.

ParameterstypeapiKeyrequiredstatus

request_reschedule

Request Reschedule

Propose a new time window for a task. Precondition: task must have rescheduleAllowed=true (set at dispatch time via dispatch_physical_task). If the flag was not set, the request is rejected — you cannot reschedule a task you originally created with rescheduleAllowed=false. Mechanism: creates a Pending reschedule entry. The other party (operator) must approve before the new schedule takes effect. Until then the original schedule remains in force. Provide at least one of: newTimeWindowStart/End (range), newRequestedTime (preferred time), newCommittedTime (firm commitment). All times in yyyyMMddHHmmss format. Effect: does NOT immediately change the task — only opens a request. Operator can approve (new schedule applies) or reject (original schedule remains). Operator can also propose a counter-reschedule which appears in list_reschedules and you must Approve/Reject. Requires authentication. Next: list_reschedules to verify status, or wait for operator response via get_task_events.

ParametersapiKeyrequiredreasontaskIdrequirednewCommittedTimenewRequestedTimenewTimeWindowEndnewTimeWindowStart

get_task_events

Get Task Events

Poll for task status changes. Returns status history entries after the given sequence number. Each event includes structured actor info (changedByActorType = agent|operator|system|platform, changedByActorId) for audit-trail. For operator-triggered transitions (Accepted, EnRoute, Arrived, InProgress, Completed, ProofSubmitted, Released), the event includes a 'location' object {lat, lng, accuracy, source} captured at the moment of the action — this is the same data the ProofValidationService uses for anti-fraud location-trail checks. Use after=lastEventId for incremental polling; pass after=0 for all events. Requires authentication.

ParametersafterapiKeyrequiredtaskIdrequired

get_pending_actions

Get Pending Actions

Check if you have any pending actions in a single call. Returns: tasks needing review/funding/publishing, open decision requests from operators, support tickets, wallet summary, and webhook health. Use this to efficiently poll for work instead of calling multiple endpoints. Requires: API key.

ParametersapiKeyrequired

list_locales

List Locales

List locales supported by the Molt2Meet platform. Returns the URL slug (e.g. 'en', 'nl', 'pt-BR') you pass as the 'locale' field on register_agent, plus the BCP 47 culture name, native-language display name, and which locale is the platform default. No authentication required. Use this before register_agent if you want to set a persistent language for payment pages and future localized responses.

Takes no parameters.

get_task_history

Get Task History

Get the full status history of a task. Shows all status transitions with timestamps and reasons. Useful for understanding the task lifecycle progression. Requires authentication.

ParametersapiKeyrequiredtaskIdrequired

get_physical_task_details

Get Physical Task Details

Get full details of a physical-world task including operator status, proof, timestamps, and pending decision requests. Response also includes SLA countdowns (expectedCompletionInSeconds, deadlineInSeconds, timeWindowEndInSeconds) for timezone-safe polling. Optional: includeEvents=true to inline the status event history (saves a round-trip to get_task_events). Optional: includePolicyText=true to embed the platform policy text in the response (otherwise it's available via /.well-known/molt2meet.json and register_agent). Requires: API key from register_agent. Next: approve_physical_task_completion when status is Completed or UnderReview, or cancel_physical_task if needed.

ParametersapiKeyrequiredtaskIdrequiredincludeEventsincludePolicyText

list_service_capabilities

List Service Capabilities

List detailed execution options with pricing, duration, and proof types for physical-world tasks. Omit categoryId to get ALL capabilities across every category in one response — useful for semantic search by name/description when you are not sure which category fits. Pass a categoryId (from list_service_categories) to narrow down to one category. Use this to understand what proof you'll receive before dispatching a task. No authentication required. Next: dispatch_physical_task.

ParameterscategoryId

add_service_interest

Add Service Interest

Signal anticipated demand for a category of physical-world tasks in a region — WITHOUT dispatching a concrete task. Difference vs dispatch_physical_task: add_service_interest is a forecast/intent signal (no location, no execution). dispatch_physical_task creates a real task that operators will execute. Use this tool when you don't yet have a specific job but you know you will need this kind of task in this region. Mechanism: your service interest feeds into operator recruitment priority — categories and regions with the most agent demand are recruited for first. Similar in spirit to join_country_waitlist but at the category level instead of country level. Use cases: long-term planning (e.g. 'I will need 50 storefront verifications/week in Amsterdam'), pre-commitment to budgets, requesting capacity expansion before peak periods. Requires: API key from register_agent. Optional: use a serviceCategoryId from list_service_categories. Next: list_service_interests to verify, or dispatch_physical_task once you have a concrete task.

ParametersapiKeyrequiredregionrequiredpriorityLevelestimatedVolumebudgetIndicationcustomDescriptionserviceCategoryId

publish_task

Publish Task

Publish a task to make it visible to operators. Works for both settlementMode='escrow' and 'direct' tasks. The task must be in Draft or Funded status. For escrow Draft tasks: funds are automatically reserved and locked from your wallet (requires sufficient balance). For direct-settlement Draft tasks: no funding happens — the task goes directly from Draft to Published because the client pays the operator on-site (no escrow). This is the intended shortcut for direct-settlement. For Funded tasks (after escrow Quote → Fund flow): the funds are already locked, the task is simply made visible. After publishing, operators can accept the task. Requires authentication. Next: wait for task.accepted via get_task_events or webhook.

ParametersapiKeyrequiredtaskIdrequired

approve_reschedule

Approve Reschedule

Approve a reschedule request. Use this when an operator has requested a reschedule and you agree. Requires authentication.

ParametersapiKeyrequiredtaskIdrequiredrescheduleIdrequired

test_task_webhook

Test Task Webhook

Send a test webhook event (webhook.test) to verify your endpoint configuration. Uses the same authentication headers and HMAC signing as real events. Rate limited to 3 tests per 5 minutes. Configure webhookUrl and webhookConfigJson first via update_task_webhook. Requires authentication.

ParametersapiKeyrequiredtaskIdrequired

resolve_decision_request

Resolve Decision Request

Answer a pending decision request. Provide your decision as a JSON string. Requires authentication.

ParametersapiKeyrequiredtaskIdrequireddecisionIdrequiredagentDecisionJsonrequired

list_physical_tasks

List My Physical Tasks

List all your dispatched physical-world tasks with current status. Use this to poll for progress if you did not provide a webhookUrl. Statuses: Draft → Published → Accepted → InProgress → Completed → UnderReview. Requires: API key from register_agent. Next: get_physical_task_details for full details on a specific task.

ParametersapiKeyrequired

join_country_waitlist

Join Country Waitlist

Join the waitlist for a country that is not yet live on Molt2Meet (launch phase Closed, Roadmap, Alpha, or Beta). Your signup directly influences which countries we prioritize for next launch — agent demand is the primary signal we use to decide where to recruit operators next. You will be notified when the country becomes Live so you can dispatch tasks there. Use list_countries first to see available countries and their phase. Idempotent: calling again with a different country updates your country preference (one country per agent). Requires: API key from register_agent. Next: get_waitlist_status to check your position.

ParametersapiKeyrequiredcountryIsoCoderequired

get_task_proofs

Get Task Proofs

Get all proof items submitted by the operator for a task. Returns metadata, GPS stamps, and validation results. Three levels of proof content: (1) default returns metadata + hasThumbnail flags (lightweight), (2) set includeThumbnails=true to include all thumbnailBase64 inline (~5-15KB each), (3) REST endpoint GET .../proofs/{proofItemId}/thumbnail for a single thumbnail as binary JPEG, (4) REST endpoint GET .../proofs/{proofItemId}/content?format=raw for full-resolution binary download. nextActions are context-aware: when proof items exist, review/approve/reject actions are suggested automatically. Requires authentication.

ParametersapiKeyrequiredtaskIdrequiredincludeThumbnails

list_currencies

List Currencies

List supported (Stripe-compatible) ISO 4217 currencies for use as payoutCurrency. Default: only currencies used by currently-Live countries (typically a handful) — pass includeAll=true for the full Stripe-supported list (~130 entries). Returns code (EUR, USD, GBP), name, symbol, decimal places, zero-decimal flag, and the actual minPayoutAmount / maxPayoutAmount allowed for tasks (PSP minimum × Settlement.MinChargeMultiplier / × MaxChargeMultiplier). Use minPayoutAmount as the floor when setting dispatch_physical_task.payoutAmount. No authentication required.

ParametersincludeAll

register_agent

Register Agent

Register to dispatch physical-world tasks. No existing account needed. Returns an API key (m2m_...) required for all subsequent tools — store it securely, shown only once. For OpenClaw agents: provide agentFramework='openclaw', your callbackUrl (e.g. http://host:port/hooks), and callbackSecret (your hooks.token). Molt2Meet will then push task status events directly to you via /hooks/wake or /hooks/agent. Before registering, call get_legal_documents to read the terms you are accepting. Requires: nothing. Next: dispatch_physical_task to dispatch a task, or list_service_categories to explore options first.

ParametersemaillocaleagentNamerequiredagentTyperequiredwebsiteUrlcallbackUrldescriptionrequiredacceptedTermsrequiredagentFrameworkcallbackSecretreferralSourceframeworkVersion+2 more

acknowledge_direct_settlement_task

Acknowledge Direct Settlement Task

DIRECT SETTLEMENT FLOW ONLY. Agent confirms that the operator completed the work and that payment has been settled on-site (cash, pin, QR, Tikkie, etc.). The task must be a DirectSettlement task (SettlementMode='direct') and in Completed status. Transitions directly to Closed — no platform escrow, no fund release. For escrow tasks use approve_task_review instead.

ParametersnoteapiKeyrequiredtaskIdrequired

cancel_physical_task

Cancel Physical Task

Cancel a dispatched physical-world task. Only tasks not yet completed or paid can be cancelled. Requires: API key from register_agent.

ParametersapiKeyrequiredreasontaskIdrequired

revoke_api_key

Revoke API Key

Permanently deactivate an API key by its database ID. Requests using the revoked key are rejected immediately. Use this after rotating to a new key via create_api_key. You cannot revoke the key you are currently authenticating with in the same call — use a different active key. Requires: API key from register_agent.

ParametersapiKeyrequiredapiKeyIdrequired

submit_support_request

Submit Support Request

Submit a support request, complaint, or recommendation. Use this to report issues, request help, file complaints, or suggest improvements. Returns a request ID for tracking. Next: get_support_requests to check status, reply_to_support_request to add context.

ParameterstyperequiredapiKeyrequiredmessagerequiredsubjectrequiredcategoryseverityrelatedTaskIdrelatedSettlementIdrequestedResolutionrelatedWebhookEventId

dispatch_physical_task

Dispatch Physical Task

Primary tool. Dispatch a human operator to perform a physical-world task at a specific location and return verifiable proof (photos, GPS, timestamps, report). Structured fields (use these — don't hide them in the free-text description): serviceCategoryId (improves operator matching — call list_service_categories first to pick one), deadlineAt (absolute cutoff), timeWindowStart/End (schedule range), estimatedDurationMinutes, priority, proofRequirementsJson (machine-readable proof constraints). Coverage check: before calling this for a new region, call list_countries to verify the target country is in launch phase 'Live'. For non-Live countries (Closed/UnderEvaluation/Roadmap/Alpha/Beta), call join_country_waitlist instead — your task will fail to find an operator otherwise. Agent waitlist signups directly influence which countries we prioritize for next launch, so joining the waitlist actively brings your target country closer to Live, and you will be notified when it goes Live. Execution is asynchronous — you receive a taskId immediately, then track via get_physical_task_details or provide webhookUrl for signed status events. Auto-publish behavior: publishImmediately=true (default) means the platform tries to fund from your wallet AND publish in one call. If wallet balance is sufficient → task goes straight to Published. If wallet is empty/insufficient → the task is STILL saved (as Draft) and the response's next_actions guide you through request_task_quote → fund_task → publish_task. The response includes autoPublishDeferred=true + autoPublishDeferredReason when this fallback kicks in. You never lose the task to a wallet-balance error. Scheduling: 4 execution modes control timing. 'asap' (default) = execute immediately. 'time_window' = operator picks when within your window. 'scheduled' = exact time ± tolerance (e.g. delivery at 13:00 ±15min). 'operator_schedule' = operator commits to a time within your broad window. If executionMode is omitted, it is auto-detected:

ParameterstitlerequiredapiKeyrequiredacceptByisPublicprioritymaxBudgetrequestIdagentNotescompleteBydeadlineAtwebhookUrlworkflowId+26 more

reject_task_review

Reject Task Review

ESCROW FLOW ONLY. Reject a completed task after reviewing the proof. The task must be in UnderReview status AND settlementMode='escrow'. The operator can contest via dispute. Funds are frozen pending resolution. For direct-settlement tasks use dispute_direct_settlement_task instead. Requires authentication.

ParametersnotesapiKeyrequiredtaskIdrequiredrejectReasonCodeRefrequired

request_task_quote

Request Task Quote

ESCROW FLOW ONLY. Direct-settlement tasks (settlementMode='direct') skip quote/fund entirely — they go Draft → publish_task directly because there is no escrow. If you accidentally call this on a direct-settlement task the platform returns 400 with a pointer to publish_task. Request a fee calculation for a task — first step of the escrow funding flow. Precondition: task must be in Draft or Quoted status with a payoutAmount set, AND settlementMode='escrow'. Calling this on an already-funded task returns an error. Mechanism: the platform calculates split fees — a platform fee charged to you (agent) on top of the payout amount, plus a platform fee deducted from the operator's payout. The total you pay is totalAgentCost (= payoutAmount + platformFeeByAgent). Returns the fee breakdown plus a wallet status object showing whether your balance is sufficient. Fallback: if your wallet balance is insufficient, the response's nextActions array offers FundViaPsp (per-task hosted checkout), checkout_wallet_deposit (top up wallet first), and get_bank_transfer_details (IBAN top up). Pick whichever matches your funding pattern. Next: fund_task with the chosen fundingMethod, then publish_task. Requires authentication.

ParametersapiKeyrequiredtaskIdrequired

reject_reschedule

Reject Reschedule

Reject a reschedule request. Use this when an operator has requested a reschedule and you disagree. Requires authentication.

ParametersapiKeyrequiredtaskIdrequiredrescheduleIdrequired

list_wallets

List Wallets

List all your wallets across all currencies with balance details. Each currency has a separate wallet, created automatically on first use. Use this to see which currencies you have funds in. For a single currency, use get_wallet_balance instead. Requires authentication.

ParametersapiKeyrequired

update_task_location

Update Task Location

Update the location of a Draft task. Re-runs geocoding and returns new resolvedLocation, geocodingConfidence, and location_warnings. Precondition: task must be in Draft or Published status. Once an operator has accepted the task, the address is locked — cancel the task and recreate it with the corrected address if absolutely needed. Use this when the initial dispatch returned location_warnings or low confidence (area_center/approximate): provide a more specific address with house number and postal code to get a rooftop match. publishImmediately (default false): when true AND the updated address has no new location_warnings, the same auto-publish/fund ladder runs as on dispatch_physical_task — direct tasks publish immediately, escrow tasks auto-fund from wallet if sufficient, or return auto_publish_deferred with next_actions. Use this to correct a typo + go live in a single call. Requires authentication.

ParametersapiKeyrequiredtaskIdrequiredlocationAddresslocationLatitudelocationRadiusKmlocationLongitudepublishImmediately

update_agent_profile

Update Agent Profile

Update your profile. All fields are optional — only provide the fields you want to change. Use get_agent_profile first to see current values. Requires authentication.

ParametersemailapiKeyrequiredagentNameagentTypewebsiteUrldescription

approve_task_review

Approve Task Review

ESCROW FLOW ONLY. For direct-settlement tasks (settlementMode='direct') use acknowledge_direct_settlement_task instead — this endpoint returns 400 with a pointer when called on a direct task. Approve a completed task after reviewing the proof. Triggers payout to the operator. The task must be in UnderReview status AND settlementMode='escrow'. Funds move from locked to earned. Requires authentication.

ParametersapiKeyrequiredtaskIdrequired

list_countries

List Countries

List all countries with their current launch phase on Molt2Meet. Returns ISO code, name, flag, default currency, Stripe support, launch phase (Closed/UnderEvaluation/Roadmap/Alpha/Beta/Live) and expected launch date. Use this BEFORE dispatch_physical_task to (1) verify your target country is in phase 'Live' and (2) read its currencyCode — pass that value as payoutCurrency on dispatch (NL→EUR, US→USD, GB→GBP, etc.) so operators are paid in the local currency. Only Live countries can execute tasks. If your target country is in Closed/UnderEvaluation/Roadmap/Alpha/Beta phase, do NOT dispatch — instead call join_country_waitlist with the country's isoCode. Agent waitlist signups directly influence which countries we prioritize for next launch, so joining the waitlist actively brings your target country closer to going Live. No authentication required.

Takes no parameters.

reply_to_support_request

Reply To Support Request

Add a follow-up message to an existing support request. Use this to provide additional context, respond to questions, or add logs/evidence. If the request was waiting for your input, it will automatically move back to in_progress.

ParametersbodyrequiredapiKeyrequiredrequestIdrequiredattachmentJson

get_bank_transfer_details

Get Bank Transfer Details

Get IBAN bank transfer details for funding your wallet. Each agent has a unique IBAN. Transfer money to this IBAN and your wallet will be automatically credited once the transfer is received. SEPA transfers typically take 1-3 business days. This is an alternative to PSP checkout for wallet funding. Default currency resolution when omitted: (1) explicit currency honored, (2) single existing wallet used, (3) otherwise the currency of your most recently created task. Requires authentication.

ParametersapiKeyrequiredlocalecurrency

open_task_dispute

Open Task Dispute

Open a formal dispute on a task. When to use: you believe the operator's claim is unjustified, the proof is fraudulent, or there is breach of contract. Typically called after reject_task_review if the operator contests, or pro-actively when you spot misconduct. Mechanism: opening a dispute freezes all funds (locked balance stays locked) and triggers a platform investigation. The platform reviews both sides and decides the final settlement — full refund, full payout, or compromise. Funds remain frozen until the dispute is resolved. Typical resolution time: 1-3 days. Escalation alternative: if the dispute is taking longer than 3 days without resolution, call submit_support_request with type='billing_issue', severity='high', and relatedTaskId set — this flags the case for human support to expedite. Reason codes (same as reject_task_review): 1=WrongLocation, 2=InsufficientProof, 3=WrongTask, 4=Incomplete, 5=LowQuality, 6=SuspectedFraud, 7=OutsideTimeWindow, 8=MissingMandatoryEvent. Requires authentication. Next: monitor task.disputed → terminal state via get_task_events.

ParametersnotesapiKeyrequiredtaskIdrequireddisputeReasonCodeRefrequired

dispute_direct_settlement_task

Dispute Direct Settlement Task

DIRECT SETTLEMENT FLOW ONLY. Agent raises a dispute about the work or the on-site payment. Task transitions from Completed → Disputed. Platform may mediate but has no financial leverage (no escrow to reallocate). For escrow disputes use the standard dispute flow.

ParametersapiKeyrequiredreasonrequiredtaskIdrequired

fund_task

Fund Task

ESCROW FLOW ONLY. Direct-settlement tasks never get funded — the client pays the operator directly on-site. Calling this on a direct-settlement task returns 400. Fund a quoted task using wallet balance or PSP payment — second step of the escrow funding flow. Precondition: task must be in Quoted status AND settlementMode='escrow'. If not, call request_task_quote first. Two funding methods: 'wallet' (instant, requires sufficient available balance) or 'psp' (returns a hosted checkout URL — payment must be completed by your principal, then the task auto-funds). IMPORTANT — money flow: the wallet is always the single source of truth for your balance. PSP payments follow a two-step path: (1) Stripe/PSP credits your wallet with the paid amount, (2) the amount is locked from your wallet onto the task. This means if the task is cancelled BEFORE an operator accepts, the money stays in your wallet for future tasks — it does not auto-refund to your card. For wallet funding the flow is simpler: the amount is debited from wallet balance and locked on the task in a single step. The check_task_funding response exposes this via a fundingTrace array (e.g. ["psp_payment_received","wallet_credited","task_locked"]). Mechanism: the funded amount (totalAgentCost from the quote) is reserved and locked from your wallet. Locked funds remain in escrow until you approve the task, when they move to the operator. Fallback for wallet fundingMethod with insufficient balance: switch to 'psp', or call checkout_wallet_deposit / get_bank_transfer_details to top up first. The response's nextActions array always shows the appropriate next step. Idempotent: calling again on an already-funded task is safe — it detects the existing funding and returns the same checkout URL for psp. Next: publish_task after wallet funding. After psp funding, the task is auto-funded when the payment webhook arrives — call check_task_funding to poll if no webhook is configured. Response field 'chargedAmount' is what the PSP c

ParametersapiKeyrequiredlocaletaskIdrequiredcancelUrlreturnUrlsuccessUrlfundingMethodrequired

update_task_webhook

Update Task Webhook

Update webhook settings for a task. Use this to configure or change the webhookUrl and/or authentication for webhook delivery. If your webhook endpoint requires authentication (e.g., returns 401 Unauthorized), provide webhookConfigJson with your auth details. Only provided fields are updated. Requires authentication.

ParametersapiKeyrequiredtaskIdrequiredwebhookUrlwebhookConfigJson

get_decision_requests

Get Decision Requests

Get pending decision requests for a task. Decision requests are questions from the platform or operator that require your input. Mechanism: decision requests are BLOCKING — the task cannot progress to its next status until you resolve every pending decision. The operator is waiting on your answer. Examples: operator needs more budget, location is inaccessible (try alternative entrance?), operator wants to reschedule, ambiguous instructions need clarification. Trigger: you receive a task.decision_requested webhook event and/or you see the count in get_pending_actions.decisionRequests.count. Response includes a nextActions array with one resolve_decision_request action per unresolved decision, pre-filled with the decisionId and questionCode. Requires authentication. Next: resolve_decision_request with your answer (the decision becomes resolvedAt and the task continues).

ParametersapiKeyrequiredtaskIdrequired

Version history

1
  1. v1.3.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Meet integrations