PeoplePerHour API and MCP server

• POST

  search_projects

  Projects buyers posted, newest first, with title, budget, category and proposal count.

  read

  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.

  POST /api/v1/peopleperhour/search_projects

  Input

  Input: search_projects

  Parameter	Type	Description
  query	string	Keywords to search for.
  since	datetime	Only projects posted after this time.
  limit	integer	1 to 50. Default: 20.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "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
  }

• POST

  get_project

  Full project brief with budget, skills and the proposals already sent.

  read

  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.

  POST /api/v1/peopleperhour/get_project

  Input

  Input: get_project

  Parameter	Type	Description
  project_id required	string	Project ID from search_projects.

  Example response

  {
    "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"
  }

• POST

  list_proposals

  Proposals you sent, newest first, with project, price and status.

  read

  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.

  POST /api/v1/peopleperhour/list_proposals

  Input

  Input: list_proposals

  Parameter	Type	Description
  status	string	Only proposals with this status, for example pending.
  limit	integer	1 to 50. Default: 20.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "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
  }

• POST

  list_workstreams

  Your WorkStream threads with buyer, project and the last message.

  read

  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.

  POST /api/v1/peopleperhour/list_workstreams

  Input

  Input: list_workstreams

  Parameter	Type	Description
  awaiting_reply	boolean	Only threads where the buyer sent the last message.
  limit	integer	1 to 50. Default: 20.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "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
  }

• POST

  get_workstream

  One WorkStream with its messages, proposals and invoices, oldest first.

  read

  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.

  POST /api/v1/peopleperhour/get_workstream

  Input

  Input: get_workstream

  Parameter	Type	Description
  workstream_id required	string	WorkStream ID from list_workstreams.

  Example response

  {
    "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"
      }
    ]
  }

• POST

  list_offers

  Your Offers with title, price and status.

  read

  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.

  POST /api/v1/peopleperhour/list_offers

  Input

  No parameters.

  Example response

  {
    "offers": [
      {
        "offer_id": "of_2209",
        "title": "Landing page design in Figma",
        "price": 350,
        "status": "live"
      }
    ]
  }

• POST

  send_proposal

  Send a proposal to a project with your brief, price, delivery time and an optional deposit.

  asks first write

  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.

  POST /api/v1/peopleperhour/send_proposal

  Input

  Input: send_proposal

  Parameter	Type	Description
  project_id required	string	Project ID from search_projects.
  brief required	string	What you will deliver and by when.
  price required	number	Your price in the project currency.
  delivery_days required	integer	Days to deliver.
  deposit_percent	integer	Share of the price to hold in Escrow up front. Default: none.

  Example response

  {
    "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"
  }

• POST

  cancel_proposal

  Cancel a proposal the buyer has not accepted yet.

  asks first write

  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.

  POST /api/v1/peopleperhour/cancel_proposal

  Input

  Input: cancel_proposal

  Parameter	Type	Description
  proposal_id required	string	Proposal ID from list_proposals.

  Example response

  {
    "proposal_id": "pp_90412",
    "status": "cancelled"
  }

• POST

  send_message

  Send a message to the buyer in a WorkStream, as you.

  asks first write

  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.

  POST /api/v1/peopleperhour/send_message

  Input

  Input: send_message

  Parameter	Type	Description
  workstream_id required	string	WorkStream ID from list_workstreams.
  body required	string	Message text.

  Example response

  {
    "workstream_id": "ws_7731",
    "message_id": "msg_5120",
    "status": "sent",
    "sent_at": "2026-10-11T08:05:00Z"
  }

• POST

  create_invoice

  Raise an invoice in a WorkStream for the buyer to pay.

  asks first write

  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.

  POST /api/v1/peopleperhour/create_invoice

  Input

  Input: create_invoice

  Parameter	Type	Description
  workstream_id required	string	WorkStream ID from list_workstreams.
  amount required	number	Invoice amount in the project currency.
  description required	string	What the invoice is for.

  Example response

  {
    "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"
  }

• POST

  create_offer

  Publish a fixed-price Offer on your profile.

  asks first write

  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.

  POST /api/v1/peopleperhour/create_offer

  Input

  Input: create_offer

  Parameter	Type	Description
  title required	string	Offer title.
  description required	string	What the buyer gets.
  price required	number	Price in your account currency.

  Example response

  {
    "offer_id": "of_2210",
    "title": "Logo refresh in 3 days",
    "price": 120,
    "status": "live"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.