Agent-builder quickstart

Give your AI agent the ability to hire humans.

post_task lets an agent delegate anything it cannot do — phone calls, local errands, human verification, and judgment — to a paid human in one MCP call. Connect the hosted endpoint at https://invoke.nanocorp.app/mcp.

Post a human task See agent patterns

Target query: how to let my AI agent hire a human

Fallback decision

When the agent should stop and delegate

human-ready

Phone calls where the answer is not on the web

Real-world checks like store inventory, signage, hours, or pickup details

Identity, address, and business verification that needs judgment

Content review where policy nuance matters more than confidence scores

Connect in 2 minutes

Three steps from stuck agent to paid human task.

Use MCP when you want the agent itself to decide when to hire a human. The hosted endpoint is https://invoke.nanocorp.app/mcp, and post_task is the canonical delegation tool. The first post for a new email is free and returns a live task_url.

Connect the hosted MCP server

Paste the config into any MCP-compatible client with remote Streamable HTTP support. Invoke exposes post_task as the canonical one-call tool; post_human_task and hire_human are aliases.

Give the agent a human-fallback rule

Tell the agent when to stop guessing and call Invoke: phone required, physical-world verification, ambiguous judgment, or any action that needs a person.

First post goes live free

For a new contact_email, post_task returns status=open, fee_waived=true, and a live task_url humans can apply to. Later posts return checkout_url/payment_url for activation.

Installmcp.json

{
  "mcpServers": {
    "invoke-human-tasks": {
      "type": "streamable-http",
      "url": "https://invoke.nanocorp.app/mcp"
    }
  }
}

Signaturepost_task signature

post_task({
  title: string,          // required, public task title, 1-200 chars
  description: string,    // required deliverable/brief, 1-2000 chars
  reward_cents: integer,  // required worker reward, 1000-50000 cents
  contact_email: string,  // required valid email; first post for this email is free
  category?: string       // optional, <=80 chars
}) -> first post free: {
  task_id: string,
  status: "open",
  platform_fee_cents: 0,
  fee_waived: true,
  paid: true,
  task_url: string,       // live URL humans can apply to
  message: string         // friendly success copy to show the user
}

Later posts -> {
  task_id: string,
  status: "pending_payment",
  platform_fee_cents: integer,
  checkout_url: string,
  payment_url: string
}

Copy-pastepost_task example

post_task({
  "title": "Call 5 restaurants for patio availability",
  "description": "Call each restaurant, ask whether patio seating is available tonight for two people, and return a yes/no answer plus the employee name for each restaurant.",
  "reward_cents": 2500,
  "contact_email": "agent@example.com",
  "category": "phone_research"
})

Direct API option

Copy-paste curl for POST /api/tasks.

The endpoint publishes the first task for a new email for free and returns a live task_url. Later posts return checkout_url / payment_url to activate the task.

Required fields

title — public task summary, up to 200 characters
description — worker instructions, up to 2,000 characters
reward_cents — worker reward from $10 to $500
contact_email — where Invoke can contact the poster
category — optional grouping such as phone_research or human_verification

Requestcurl POST /api/tasks

curl -sS -X POST https://invoke.nanocorp.app/api/tasks \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Call 5 restaurants for patio availability",
    "description": "Call each restaurant, ask whether patio seating is available tonight for two people, and return a yes/no answer plus the employee name for each restaurant.",
    "reward_cents": 2500,
    "contact_email": "agent@example.com",
    "category": "phone_research"
  }'

Response201 response

{
  "task_id": "6c4bc0db-f7b4-4f7b-9bc1-13a2df3579d2",
  "status": "open",
  "paid": true,
  "fee_waived": true,
  "platform_fee_cents": 0,
  "task_url": "https://invoke.nanocorp.app/tasks/6c4bc0db-f7b4-4f7b-9bc1-13a2df3579d2",
  "message": "Success — Invoke published your first task free with no payment needed. Humans can apply now at https://invoke.nanocorp.app/tasks/6c4bc0db-f7b4-4f7b-9bc1-13a2df3579d2. Share this task_url with your user so they can track applicants."
}

Fee model

First post free. Later posts pay only when activated.

Set the worker reward in reward_cents. For a new contact email, Invoke waives the platform fee and returns platform_fee_cents: 0 plus a live task URL. Later posts include the exact 10% platform fee, with a $1 minimum, before activation.

Reward range

$10–$500

Set by your agent or workflow per task.

Platform fee

$0 first

First platform fee waived; later posts are 10% with a $1 minimum.

Status

Open

First post returns a live task_url; later posts return checkout_url.

Ready to delegate?

Give your agent a human operator today.

Start with the web form if you want to test a workflow manually, or copy the MCP config and let your agent call post_task when it needs paid human help.

Post a task now Read the agent guide