PeoplePerHour MCP tools

MCP tool peopleperhour_search_projects

Returns projects from the same search as the website, newest first. Filter by keyword or by posting time to read only what came in since your last check. Each item has the budget the buyer set; get_project returns the full brief. Pass next_cursor back as cursor for the next page.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_search_projects",
    "arguments": {
      "query": "web design",
      "since": "2026-10-11T07:00:00Z",
      "limit": 20
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "projects": [
      {
        "project_id": "pj_48213",
        "title": "Landing page design for a SaaS launch",
        "budget": {
          "amount": 500,
          "currency": "GBP"
        },
        "category": "Design",
        "proposals": 4,
        "posted_at": "2026-10-10T08:12:00Z",
        "url": "https://www.peopleperhour.com/freelance-jobs/design/landing-page-design-for-a-saas-launch-48213"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

MCP tool peopleperhour_get_project

Returns one project with the buyer's full brief, budget, required skills and how many proposals it has. Use it before send_proposal so your agent reads the brief instead of the title.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_get_project",
    "arguments": {
      "project_id": "project_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "project_id": "pj_48213",
    "title": "Landing page design for a SaaS launch",
    "brief": "We need a one-page design in Figma for our launch on 1 November. Copy is ready.",
    "budget": {
      "amount": 500,
      "currency": "GBP"
    },
    "skills": [
      "Web design",
      "Figma"
    ],
    "proposals": 4,
    "posted_at": "2026-10-10T08:12:00Z"
  },
  "isError": false
}

MCP tool peopleperhour_list_proposals

Lists the proposals on your account, newest first, with the project, your price and whether the buyer has accepted it. Filter by status to find the ones still waiting. Pass proposal_id to cancel_proposal.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_list_proposals",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "proposals": [
      {
        "proposal_id": "pp_90412",
        "project_id": "pj_48213",
        "project_title": "Landing page design for a SaaS launch",
        "price": 450,
        "status": "pending",
        "sent_at": "2026-10-10T09:30:00Z"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

MCP tool peopleperhour_list_workstreams

Lists your WorkStreams, most recent first, each with the buyer, the project and a preview of the last message. Set awaiting_reply to see only threads where the buyer wrote last. Use the workstream_id with get_workstream, send_message and create_invoice.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_list_workstreams",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "workstreams": [
      {
        "workstream_id": "ws_7731",
        "buyer": "Maria S.",
        "project_title": "Landing page design for a SaaS launch",
        "last_message": "Can you start on Monday?",
        "last_from": "buyer",
        "updated_at": "2026-10-11T07:40:00Z"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

MCP tool peopleperhour_get_workstream

Returns one WorkStream in order, oldest first: messages, the proposals sent in it, invoices raised and file names shared. Read it before replying so your agent sees the whole history with this buyer.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_get_workstream",
    "arguments": {
      "workstream_id": "workstream_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "workstream_id": "ws_7731",
    "buyer": "Maria S.",
    "items": [
      {
        "type": "proposal",
        "proposal_id": "pp_90412",
        "price": 450,
        "sent_at": "2026-10-10T09:30:00Z"
      },
      {
        "type": "message",
        "from": "buyer",
        "body": "Can you start on Monday?",
        "sent_at": "2026-10-11T07:40:00Z"
      }
    ]
  },
  "isError": false
}

MCP tool peopleperhour_list_offers

Lists the fixed-price Offers on your profile, newest first, with title, price and whether each is live. Use it to check what you already sell before creating another.

Parameters

No parameters.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_list_offers",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "offers": [
      {
        "offer_id": "of_2209",
        "title": "Landing page design in Figma",
        "price": 350,
        "status": "live"
      }
    ]
  },
  "isError": false
}

MCP tool peopleperhour_send_proposal

Sends a proposal on one project under your name. It takes a brief of what you will deliver, a price, a delivery time and optionally a deposit to hold in Escrow. It counts against your free Proposals for the month; more are bought as Proposal credits. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_send_proposal",
    "arguments": {
      "project_id": "pj_48213",
      "brief": "I will design the landing page in Figma and hand over the files, with two rounds of changes.",
      "price": 450,
      "delivery_days": 7,
      "deposit_percent": 20
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "proposal_id": "pp_90412",
    "project_id": "pj_48213",
    "status": "pending",
    "price": 450,
    "delivery_days": 7,
    "deposit_percent": 20,
    "workstream_id": "ws_7731",
    "sent_at": "2026-10-10T09:30:00Z"
  },
  "isError": false
}

MCP tool peopleperhour_cancel_proposal

Cancels one pending proposal. An accepted proposal cannot be cancelled and the call fails. The buyer sees the proposal withdrawn, so use it before sending a corrected one. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_cancel_proposal",
    "arguments": {
      "proposal_id": "proposal_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "proposal_id": "pp_90412",
    "status": "cancelled"
  },
  "isError": false
}

MCP tool peopleperhour_send_message

Posts a message in one WorkStream under your name. Each WorkStream is one buyer and one project, so a message never reaches other buyers. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_send_message",
    "arguments": {
      "workstream_id": "ws_7731",
      "body": "Tuesday at 10:00 works for me. I will bring the second layout so we can pick one on the call."
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "workstream_id": "ws_7731",
    "message_id": "msg_5120",
    "status": "sent",
    "sent_at": "2026-10-11T08:05:00Z"
  },
  "isError": false
}

MCP tool peopleperhour_create_invoice

Raises an invoice in one WorkStream. The buyer is asked to pay it, so it reaches money and the other person. Amount and description are the ones you pass. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_create_invoice",
    "arguments": {
      "workstream_id": "ws_7731",
      "amount": 450,
      "description": "Landing page design in Figma, final files delivered and approved"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "invoice_id": "inv_3318",
    "workstream_id": "ws_7731",
    "amount": 300,
    "description": "Landing page design, week 2",
    "status": "sent",
    "raised_at": "2026-10-16T16:00:00Z"
  },
  "isError": false
}

MCP tool peopleperhour_create_offer

Publishes an Offer on your profile with a title, description and price, visible to buyers. It reaches the public, so it asks first. By default you confirm each call; you can switch that off for this tool.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peopleperhour_create_offer",
    "arguments": {
      "title": "title",
      "description": "description",
      "price": 1
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "offer_id": "of_2210",
    "title": "Logo refresh in 3 days",
    "price": 120,
    "status": "live"
  },
  "isError": false
}