Peerspace MCP tools

MCP tool peerspace_list_listings

Returns every listing on your host account with its space, base rate, whether Instant Book is on and whether the listing is live or paused. A paused listing cannot be booked and is hidden from search, and guests cannot contact you about it. Use the IDs here in the other calls.

Parameters

No parameters.

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "listings": [
      {
        "listing_id": "l_30918",
        "space_id": "s_4410",
        "title": "Daylight loft studio",
        "base_hourly_rate": 120,
        "instant_book": false,
        "status": "live"
      },
      {
        "listing_id": "l_30922",
        "space_id": "s_4410",
        "title": "Daylight loft, events",
        "base_hourly_rate": 150,
        "instant_book": false,
        "status": "paused"
      }
    ]
  },
  "isError": false
}

MCP tool peerspace_list_bookings

Lists bookings and requests, each with guest first name, start and end, attendees and the status. Requests carry an expires_at, two business days after you received them, so your agent can answer the oldest first. Use booking_id with get_booking, accept_booking_request and decline_booking_request.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "bookings": [
      {
        "booking_id": "b_90417",
        "listing_id": "l_30918",
        "guest": "Dana",
        "status": "requested",
        "start": "2026-10-17T14:00:00-07:00",
        "end": "2026-10-17T18:00:00-07:00",
        "attendees": 12,
        "expires_at": "2026-10-14T09:12:00-07:00"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

MCP tool peerspace_get_booking

Returns the full record of one booking or request, including the add-ons attached, the price and the payout you expect after Peerspace's service fee. For a request it also returns when it expires. Read it before you accept or decline.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "booking_id": "b_90417",
    "listing_id": "l_30918",
    "guest": "Dana",
    "status": "requested",
    "start": "2026-10-17T14:00:00-07:00",
    "end": "2026-10-17T18:00:00-07:00",
    "attendees": 12,
    "activity": "Photo shoot",
    "add_ons": [
      {
        "name": "Backdrop set",
        "price": 50
      }
    ],
    "subtotal": 480,
    "total": 530,
    "expected_payout": 477,
    "expires_at": "2026-10-14T09:12:00-07:00"
  },
  "isError": false
}

MCP tool peerspace_list_conversations

Lists your Peerspace inbox threads, each linked to an inquiry or a booking. Set unanswered_only to get only threads where the guest wrote last, which is what response rate is measured on. Pass next_cursor back as cursor for the next page.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversations": [
      {
        "conversation_id": "c_58210437",
        "guest": "Dana",
        "about": "inquiry",
        "last_message_at": "2026-10-11T08:40:00-07:00",
        "guest_wrote_last": true
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

MCP tool peerspace_get_conversation

Returns the whole thread, oldest message first, with the inquiry or booking it is about. Your agent reads it before replying so it does not repeat an earlier answer.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": "c_58210437",
    "about": "inquiry",
    "messages": [
      {
        "from": "guest",
        "sent_at": "2026-10-11T08:40:00-07:00",
        "body": "Hi! Is parking free, and can we shoot on Oct 24?"
      }
    ]
  },
  "isError": false
}

MCP tool peerspace_get_calendar

Returns what the Peerspace calendar shows for one space between two dates: inquiries, requests and bookings. Inquiries and requests do not block the time, so it still looks open to guests; accepted bookings do. Check it before you accept a request.

Parameters

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "peerspace_get_calendar",
    "arguments": {
      "space_id": "space_8c41d2",
      "from": "2026-10-01",
      "to": "2026-10-01"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "space_id": "s_4410",
    "days": [
      {
        "date": "2026-10-17",
        "items": [
          {
            "type": "request",
            "booking_id": "b_90417",
            "start": "14:00",
            "end": "18:00"
          }
        ]
      },
      {
        "date": "2026-10-18",
        "items": [
          {
            "type": "booking",
            "booking_id": "b_90388",
            "start": "10:00",
            "end": "13:00"
          }
        ]
      }
    ]
  },
  "isError": false
}

MCP tool peerspace_list_payouts

Lists the payouts from your payout dashboard. A payout is scheduled 72 hours after the booking ends, becomes processing once initiated and processed after it is paid out. Each entry lists what is inside it, because the payout for a booking and for its overtime can arrive separately.

Parameters

tools/call

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

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "payouts": [
      {
        "payout_id": "p_7710",
        "status": "scheduled",
        "date": "2026-10-20",
        "amount": 842.5,
        "includes": [
          {
            "type": "booking",
            "booking_id": "b_90388",
            "amount": 800
          },
          {
            "type": "overtime",
            "booking_id": "b_90388",
            "amount": 42.5
          }
        ]
      }
    ]
  },
  "isError": false
}

MCP tool peerspace_send_message

Sends a message in an existing thread under your name; the guest gets it in the Peerspace inbox. It cannot start a thread with a stranger, only answer 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": "peerspace_send_message",
    "arguments": {
      "conversation_id": "c_58210437",
      "body": "Hi Dana, Oct 24 is open for 20 people. Parking for 6 cars is free on site, and load-in is through the back door on 3rd St. Want me to send you an offer for the hours you need?"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "message_id": "m_6204188",
    "conversation_id": "c_58210437",
    "status": "sent",
    "sent_at": "2026-10-11T09:05:00-07:00"
  },
  "isError": false
}

MCP tool peerspace_send_custom_offer

Sends an invite-to-book from a guest thread. Spaces without a food and beverage minimum take a rental fee; spaces with one also take minimum spend and gratuity. Sales tax on minimum spend and add-ons is added automatically, so do not include it. The guest then has 7 days to review and submit payment. 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": "peerspace_send_custom_offer",
    "arguments": {
      "conversation_id": "c_58210437",
      "start": "2026-10-24T10:00:00-07:00",
      "end": "2026-10-24T16:00:00-07:00",
      "attendees": 20,
      "rental_fee": 900,
      "note": "Six hours for your team offsite, setup from 9:30."
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "offer_id": "o_7731905",
    "conversation_id": "c_58210437",
    "status": "sent",
    "rental_fee": 900,
    "expires_at": "2026-10-18T09:05:00-07:00"
  },
  "isError": false
}

MCP tool peerspace_accept_booking_request

Accepts a request from the Bookings tab. The booking is confirmed and the guest's card is charged for the full amount. A request you leave alone expires after two business days. 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": "peerspace_accept_booking_request",
    "arguments": {
      "booking_id": "b_90417"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "booking_id": "b_90417",
    "status": "confirmed",
    "start": "2026-10-17T14:00:00-07:00",
    "end": "2026-10-17T18:00:00-07:00",
    "total": 530
  },
  "isError": false
}

MCP tool peerspace_decline_booking_request

Declines a request. The authorization hold on the guest's card is released. Declining counts as a response for your response rate, an expired request does not. 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": "peerspace_decline_booking_request",
    "arguments": {
      "booking_id": "booking_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "booking_id": "b_90421",
    "status": "declined"
  },
  "isError": false
}

MCP tool peerspace_request_booking_update

Sends an update request on a confirmed booking; the guest accepts or declines. If they accept, the change applies at once. If they decline, or do not answer within two business days, the original booking stays. If you change the hours, set the new price yourself: it does not update on its own, and 8+ hour discounts do not apply to host updates. 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": "peerspace_request_booking_update",
    "arguments": {
      "booking_id": "booking_8c41d2",
      "fields": "fields"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "booking_id": "b_90388",
    "update_id": "u_2045",
    "status": "pending_guest",
    "fields": {
      "end": "2026-10-18T14:00:00-07:00",
      "subtotal": 800
    }
  },
  "isError": false
}

MCP tool peerspace_block_calendar_time

Blocks the time for all guests, including guests with a pending inquiry or offer. The title is a private reminder that guests cannot see. There is no call to unblock. 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": "peerspace_block_calendar_time",
    "arguments": {
      "space_id": "space_8c41d2",
      "start": "2026-10-01T09:00:00Z",
      "end": "2026-10-01T09:00:00Z"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "block_id": "blk_5531",
    "space_id": "s_4410",
    "start": "2026-11-03T00:00:00-08:00",
    "end": "2026-11-03T23:59:00-08:00",
    "title": "Maintenance"
  },
  "isError": false
}

MCP tool peerspace_add_calendar_rate

Adds a calendar rate to one listing: a name, a rate and the days and times it applies to. Guests see it at checkout once they enter start and end times. Rates far above your base rate can hurt conversion, and Peerspace may remove accounts that use rates to mislead guests. 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": "peerspace_add_calendar_rate",
    "arguments": {
      "listing_id": "listing_8c41d2",
      "name": "Jane Doe",
      "hourly_rate": 1,
      "days": [
        "days"
      ]
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "listing_id": "l_30918",
    "rate_id": "r_8802",
    "name": "Weekend",
    "hourly_rate": 150,
    "days": [
      "sat",
      "sun"
    ]
  },
  "isError": false
}

MCP tool peerspace_set_instant_book

Switches the Instant Book toggle for one listing. If the toggle is not available on the listing, the call fails and you need to use Request Access in Peerspace first. You can turn it on or off at any time. 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": "peerspace_set_instant_book",
    "arguments": {
      "listing_id": "listing_8c41d2",
      "enabled": true
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "listing_id": "l_30918",
    "instant_book": true
  },
  "isError": false
}