Thryv API and MCP server

• POST

  list_clients

  Clients with contact details and tags, newest first.

  read

  Lists the clients on your account, newest first. Filter by name, email or tag to find a group such as everyone tagged "spring". Pages hold up to 100 clients; pass next_cursor back as cursor for the next page.

  POST /api/v1/thryv/list_clients

  Input

  Input: list_clients

  Parameter	Type	Description
  search	string	Name or email.
  tag	string	Only clients with this tag.
  limit	integer	1 to 100. Default: 50.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "clients": [
      {
        "client_id": "cl_8f2a91",
        "name": "Sample Client",
        "email": "client@example.com",
        "phone": "+1 555 0100",
        "tags": [
          "spring"
        ]
      },
      {
        "client_id": "cl_20b4d7",
        "name": "Jordan Hale",
        "email": "jordan@example.com",
        "phone": "+1 555 0101",
        "tags": [
          "spring",
          "lawn"
        ]
      }
    ],
    "next_cursor": null
  }

• POST

  get_client

  Client card: contact details, tags, notes, client details, appointments, invoices and message history.

  read

  Returns one client card with contact details, tags, internal notes, appointments, invoices and the message history. Use it before replying or invoicing so your agent sees everything about the client.

  POST /api/v1/thryv/get_client

  Input

  Input: get_client

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.

  Example response

  {
    "client_id": "cl_8f2a91",
    "name": "Sample Client",
    "email": "client@example.com",
    "tags": [
      "spring"
    ],
    "notes": "Prefers morning visits.",
    "appointments": [
      {
        "appointment_id": "ap_40b2d8",
        "service": "Lawn treatment",
        "start": "2026-09-29T09:00:00-05:00"
      }
    ],
    "invoices": [
      {
        "invoice_id": "inv_2041",
        "total": "85.00",
        "balance_due": "0.00"
      }
    ],
    "messages": 3
  }

• POST

  list_services

  Services from your services menu, with their saved prices.

  read

  Returns the services on your services menu with their saved prices. Use the name as the service parameter of book_appointment.

  POST /api/v1/thryv/list_services

  Input

  No parameters.

  Example response

  {
    "services": [
      {
        "name": "Lawn treatment",
        "price": "85.00"
      },
      {
        "name": "Edging",
        "price": "25.00"
      }
    ]
  }

• POST

  list_appointments

  Calendar appointments in a date range, with client, service, staff and price.

  read

  Lists calendar appointments between two dates, with client, service, staff and price. The range is at most 31 days. Filter by staff member to see one person's calendar.

  POST /api/v1/thryv/list_appointments

  Input

  Input: list_appointments

  Parameter	Type	Description
  from required	date	First day.
  to required	date	Last day, at most 31 days after from.
  staff	string	Only this staff member.

  Example response

  {
    "appointments": [
      {
        "appointment_id": "ap_40b2d8",
        "client": "Sample Client",
        "client_id": "cl_8f2a91",
        "service": "Lawn treatment",
        "start": "2026-10-13T09:00:00-05:00",
        "end": "2026-10-13T10:00:00-05:00",
        "staff": "Alex",
        "price": "85.00"
      },
      {
        "appointment_id": "ap_40b2d9",
        "client": "Jordan Hale",
        "client_id": "cl_20b4d7",
        "service": "Edging",
        "start": "2026-10-13T11:00:00-05:00",
        "end": "2026-10-13T11:30:00-05:00",
        "staff": "Alex",
        "price": "25.00"
      }
    ]
  }

• POST

  list_invoices

  Invoices from the Sales tab with client, total, balance due and dates.

  read

  Lists invoices from the Sales tab with client, total, balance due and dates. Set unpaid_only to skip invoices paid in full. Pages hold up to 100 invoices.

  POST /api/v1/thryv/list_invoices

  Input

  Input: list_invoices

  Parameter	Type	Description
  client_id	string	Only this client.
  unpaid_only	boolean	Skip invoices paid in full.
  limit	integer	1 to 100. Default: 50.

  Example response

  {
    "invoices": [
      {
        "invoice_id": "inv_2044",
        "client": "Jordan Hale",
        "client_id": "cl_20b4d7",
        "total": "110.00",
        "balance_due": "110.00",
        "issued": "2026-10-05",
        "due": "2026-10-19"
      }
    ]
  }

• POST

  list_conversations

  Inbox conversations with the latest messages, across email, text and other connected channels.

  read

  Lists inbox conversations with the latest messages, across email, text and the other channels you connected in Thryv. Filter by client to see one thread. Pages hold up to 50 conversations.

  POST /api/v1/thryv/list_conversations

  Input

  Input: list_conversations

  Parameter	Type	Description
  client_id	string	Only this client.
  limit	integer	1 to 50. Default: 20.

  Example response

  {
    "conversations": [
      {
        "conversation_id": "cv_77d2",
        "client": "Sample Client",
        "client_id": "cl_8f2a91",
        "channel": "text",
        "last_message": "Can we move Tuesday to 10:00?",
        "updated_at": "2026-10-10T16:02:00-05:00"
      }
    ]
  }

• POST

  list_reviews

  Reviews from the Reputation dashboard, from every connected site, with rating and whether you replied.

  read

  Lists reviews from the Reputation dashboard, from every site you connected, with rating, text and whether you replied. Use unanswered_only to see what needs a reply. Pass review_id to reply_to_review.

  POST /api/v1/thryv/list_reviews

  Input

  Input: list_reviews

  Parameter	Type	Description
  unanswered_only	boolean	Skip reviews you already answered.
  since	date	Only reviews posted on or after this date.

  Example response

  {
    "reviews": [
      {
        "review_id": "rv_3b90c1",
        "site": "Google",
        "rating": 5,
        "author": "Dana K.",
        "text": "The lawn looks great.",
        "posted": "2026-10-08",
        "replied": false
      }
    ]
  }

• POST

  add_client

  New client card. Nothing is sent to the client.

  write

  Creates a client card. Nothing is sent to the client, and the card can be edited or removed in Thryv, so the call skips confirmation. Only the first name is required.

  POST /api/v1/thryv/add_client

  Input

  Input: add_client

  Parameter	Type	Description
  first_name required	string	First name.
  last_name	string	Last name.
  email	string	Email address.
  phone	string	Phone number.
  tags	string[]	Tags to add.
  notes	string	Internal notes, not shown to the client.

  Example response

  {
    "client_id": "cl_8f2a91",
    "name": "Sam Lee",
    "email": "client@example.com",
    "tags": [
      "spring"
    ],
    "status": "created"
  }

• POST

  book_appointment

  New calendar appointment. Thryv emails the client a booking confirmation.

  asks first write

  Books an appointment on your calendar for a client. Thryv emails the client a booking confirmation, plus any extra recipients you add. End time defaults to the service length and staff to the primary admin. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thryv/book_appointment

  Input

  Input: book_appointment

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  service required	string	Service name from list_services, or a custom title.
  start required	datetime	ISO 8601 with time zone.
  end	datetime	End time. Default: the service length.
  staff	string	Staff member. Default: the primary admin.
  price_type	enum	fixed, custom or no_fee. Default: the service setting.
  price	string	Price for a fixed-price appointment.
  additional_recipients	string[]	More emails that get the booking email.

  Example response

  {
    "appointment_id": "ap_51c7e0",
    "client": "Sample Client",
    "service": "Lawn treatment",
    "start": "2026-10-13T09:00:00-05:00",
    "end": "2026-10-13T10:00:00-05:00",
    "staff": "Alex",
    "price": "85.00",
    "confirmation_sent_to": [
      "client@example.com"
    ]
  }

• POST

  mark_no_show

  Mark an appointment as a no-show, before its end time. May send your missed appointment email.

  asks first write

  Marks one appointment as a no-show, before its end time. If you set up a missed appointment email in Thryv, it may go out to the client. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thryv/mark_no_show

  Input

  Input: mark_no_show

  Parameter	Type	Description
  appointment_id required	string	Appointment ID from list_appointments.

  Example response

  {
    "appointment_id": "ap_40b2d9",
    "status": "no_show"
  }

• POST

  create_estimate

  Itemized estimate on the client card, saved or sent for approval in the client portal.

  asks first write

  Creates an itemized estimate on the client card. With send false it is only saved; with send true it goes to the client for approval in the client portal. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thryv/create_estimate

  Input

  Input: create_estimate

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  line_items required	object[]	List of items, each with description, quantity and unit_price.
  notes	string	Notes shown on the estimate.
  send	boolean	Send it to the client now. Default: false.

  Example response

  {
    "estimate_id": "est_1180",
    "client_id": "cl_8f2a91",
    "total": "110.00",
    "status": "saved"
  }

• POST

  create_invoice

  Invoice on the client card, saved to send later or sent with an online payment link.

  asks first write

  Creates an invoice on the client card from line items. With send false it is saved to send later; with send true it goes to the client with an online payment link. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thryv/create_invoice

  Input

  Input: create_invoice

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  line_items required	object[]	List of items, each with description, quantity and unit_price.
  send	boolean	Send it to the client now. Default: false.

  Example response

  {
    "invoice_id": "inv_2051",
    "client_id": "cl_8f2a91",
    "line_items": [
      {
        "description": "Lawn treatment",
        "quantity": 1,
        "unit_price": "85.00"
      },
      {
        "description": "Edging",
        "quantity": 1,
        "unit_price": "25.00"
      }
    ],
    "total": "110.00",
    "balance_due": "110.00",
    "status": "draft"
  }

• POST

  send_message

  Message one or more clients, the same as Send Message on your dashboard.

  asks first write

  Sends a message to one or more clients, the same as Send Message on your dashboard. Subject and message text are required. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thryv/send_message

  Input

  Input: send_message

  Parameter	Type	Description
  client_ids required	string[]	Client IDs from list_clients.
  subject required	string	Subject line.
  message required	string	Message text.

  Example response

  {
    "sent_to": [
      "cl_8f2a91",
      "cl_20b4d7"
    ],
    "subject": "Open slots next week",
    "status": "sent"
  }

• POST

  reply_to_review

  Post a public reply to a review from the Reputation dashboard.

  asks first write

  Posts a public reply to one review from the Reputation dashboard. The reply is visible to anyone who reads the review. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thryv/reply_to_review

  Input

  Input: reply_to_review

  Parameter	Type	Description
  review_id required	string	Review ID from list_reviews.
  text required	string	Reply text.

  Example response

  {
    "review_id": "rv_3b90c1",
    "status": "published"
  }

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.