Angi API and MCP server Let your AI agent work your Angi leads.

ToolWhat it doesAccess

• list_leads Returns the leads in the Leads tab of your Angi business account, newest first. read

  Returns the homeowner name, the project, the received time and the status for each lead, as the Leads tab shows them. Use get_lead for the full details of one lead. An export in Angi covers up to 1,000 leads at a time, so ask for a date range on a long history.

  MCP callangi_read → list_leads

  REST endpointGET https://cotlet.dev/api/v1/angi/leads

  Parameters

  Parameters: list_leads

  Name	Type	Description
  status string	string	Only leads with this status, as shown on the lead in Angi.
  since string	string	Only leads received after this ISO date.
  limit integer	integer	Maximum number of leads to return.

  Example response

  {
    "leads": [
      {
        "lead_id": "lead_8f3a21",
        "homeowner": "Dana Whitfield",
        "service": "Roof repair",
        "zip": "30305",
        "received_at": "2026-10-27T14:05:00-04:00",
        "status": "New"
      },
      {
        "lead_id": "lead_5c91de",
        "homeowner": "Luis Ortega",
        "service": "Gutter installation",
        "zip": "30309",
        "received_at": "2026-10-27T09:40:00-04:00",
        "status": "New"
      }
    ]
  }

• get_lead Returns the homeowner and project details of one lead, with your private notes. read

  Returns what the lead page shows: homeowner contact details, the project request, the status, your rating and your notes. Notes are private to your business and never shown to the homeowner.

  MCP callangi_read → get_lead

  REST endpointGET https://cotlet.dev/api/v1/angi/leads/{lead_id}

  Parameters

  Parameters: get_lead

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.

  Example input

  {
    "lead_id": "lead_8c41d2"
  }

  Example response

  {
    "lead_id": "lead_8f3a21",
    "homeowner": "Dana Whitfield",
    "phone": "555-0142",
    "email": "dana@example.com",
    "service": "Roof repair",
    "zip": "30305",
    "description": "Two missing shingles after the storm.",
    "status": "New",
    "rating": null,
    "notes": ""
  }

• send_lead_message Sends a message to the homeowner of a lead from the Angi for Pros inbox. writeasks first

  Sends the message in Angi. The homeowner gets an SMS text notification and sees it in the Angi consumer app. It reaches a real person, so by default you confirm each call; you can switch that off for this tool.

  MCP callangi_write → send_lead_message

  REST endpointPOST https://cotlet.dev/api/v1/angi/leads/{lead_id}/message

  Parameters

  Parameters: send_lead_message

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.
  message string required	string	The message text.

  Example input

  {
    "lead_id": "lead_8f3a21",
    "message": "Hi Dana, this is Mike from Summit Roofing. I can look at your roof on Thursday morning. Does 9:00 work?"
  }

  Example response

  {
    "lead_id": "lead_8f3a21",
    "status": "sent",
    "sent_at": "2026-10-28T08:12:00-04:00"
  }

• set_lead_status Sets the status of a lead, the way Set status does in Angi. write

  Changes only your own pipeline view and reaches no one. It is undone with another call, so it needs no confirmation. Returns the new status.

  MCP callangi_write → set_lead_status

  REST endpointPUT https://cotlet.dev/api/v1/angi/leads/{lead_id}/status

  Parameters

  Parameters: set_lead_status

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.
  status string required	string	A status offered by Angi for this lead, for example one that marks it won or lost.

  Example input

  {
    "lead_id": "lead_8c41d2",
    "status": "status"
  }

  Example response

  {
    "lead_id": "lead_8f3a21",
    "status": "Contacted"
  }

• add_lead_note Adds a private note to a lead, and can rate its quality from 1 to 5 stars. write

  Notes are visible only to your business, never to the homeowner. Angi uses the lead rating to improve its leads. It reaches no one and is undone with another call, so it needs no confirmation.

  MCP callangi_write → add_lead_note

  REST endpointPOST https://cotlet.dev/api/v1/angi/leads/{lead_id}/note

  Parameters

  Parameters: add_lead_note

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.
  note string	string	The note text.
  rating integer	integer	Lead quality in stars, 1 to 5.

  Example input

  {
    "lead_id": "lead_8c41d2"
  }

  Example response

  {
    "lead_id": "lead_8f3a21",
    "note": "Called, wants a visit Thursday.",
    "rating": 4
  }

ToolWhat it doesAccess

• request_lead_credit Asks Angi for a credit for a lead you were charged for. writeasks first

  Submits the request and returns its state. Angi reviews it within 5 business days and applies an approved credit to future lead charges; credits expire six months after issue. Angi considers a lead only if it is under 45 days old, you called the homeowner within 24 hours, your account has no overdue balance and you have no annual subscription. By default you confirm each call; you can switch that off for this tool.

  MCP callangi_write → request_lead_credit

  REST endpointPOST https://cotlet.dev/api/v1/angi/leads/{lead_id}/credit/request

  Parameters

  Parameters: request_lead_credit

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.
  reason string required	string	One of invalid_contact_info, wrong_location, service_mismatch, duplicate_lead, paused_leads.
  details string	string	Extra details for Angi.

  Example input

  {
    "lead_id": "lead_8c41d2",
    "reason": "reason"
  }

  Example response

  {
    "lead_id": "lead_5c91de",
    "reason": "invalid_contact_info",
    "state": "submitted",
    "review_within": "5 business days"
  }

ToolWhat it doesAccess

• list_reviews Returns the homeowner reviews of your business from the Reviews tab. read

  Returns the reviewer, the text, the date and whether you have replied. Angi shows a reply as pending until its team has reviewed it. Reviews imported from Google appear in the same tab.

  MCP callangi_read → list_reviews

  REST endpointGET https://cotlet.dev/api/v1/angi/reviews

  Parameters

  Parameters: list_reviews

  Name	Type	Description
  unanswered boolean	boolean	Only reviews you have not replied to.
  limit integer	integer	Maximum number of reviews to return.

  Example response

  {
    "reviews": [
      {
        "review_id": "rev_1a77",
        "reviewer": "Karen Lowe",
        "text": "On time and tidy, would hire again.",
        "date": "2026-10-22",
        "replied": false
      },
      {
        "review_id": "rev_1a52",
        "reviewer": "Tom Reyes",
        "text": "The quote changed after the visit.",
        "date": "2026-10-15",
        "replied": true
      }
    ]
  }

• reply_to_review Adds your public comment to a homeowner review. writeasks first

  Saves the comment the way Add a Comment does in Angi. The reply may show as pending until a member of the Angi team reviews it, then it goes live for everyone. By default you confirm each call; you can switch that off for this tool.

  MCP callangi_write → reply_to_review

  REST endpointPOST https://cotlet.dev/api/v1/angi/reviews/{review_id}/replies

  Parameters

  Parameters: reply_to_review

  Name	Type	Description
  review_id string required	string	Review ID from list_reviews.
  comment string required	string	Your reply text.

  Example input

  {
    "review_id": "review_8c41d2",
    "comment": "comment"
  }

  Example response

  {
    "review_id": "rev_1a77",
    "status": "pending"
  }

• request_homeowner_review Asks a homeowner for a review, from a lead or by email. writeasks first

  Sends the request the way Request reviews does in Angi. Angi caps the requests per homeowner and does not publish the number, so a call can be refused. By default you confirm each call; you can switch that off for this tool.

  MCP callangi_write → request_homeowner_review

  REST endpointPOST https://cotlet.dev/api/v1/angi/homeowner-review/request

  Parameters

  Parameters: request_homeowner_review

  Name	Type	Description
  lead_id string	string	Lead ID from list_leads. Use this or email.
  email string	string	Homeowner email for a customer who did not come through Angi.
  name string	string	Homeowner name, used with email.

  Example response

  {
    "lead_id": "lead_8f3a21",
    "status": "sent"
  }

ToolWhat it doesAccess

• list_service_locations Returns the ZIP codes where you receive leads, and whether each one is on. read

  Returns the ZIP codes of the Service locations page, each switched on or off. Your tasks (services offered) are read-only here: Angi changes them only by phone.

  MCP callangi_read → list_service_locations

  REST endpointGET https://cotlet.dev/api/v1/angi/service-locations

  Parameters

  No parameters.

  Example response

  {
    "locations": [
      {
        "zip": "30305",
        "enabled": true
      },
      {
        "zip": "30309",
        "enabled": true
      },
      {
        "zip": "30318",
        "enabled": false
      }
    ]
  }

• update_service_location Switches one ZIP code on or off for your lead flow. writeasks first

  Changes where Angi sends you paid leads. Angi applies the change overnight. With an annual subscription or multiple service locations, Angi allows the change only by phone and the call fails. By default you confirm each call; you can switch that off for this tool.

  MCP callangi_write → update_service_location

  REST endpointPATCH https://cotlet.dev/api/v1/angi/service-location

  Parameters

  Parameters: update_service_location

  Name	Type	Description
  zip string required	string	ZIP code from list_service_locations.
  enabled boolean required	boolean	true to receive leads there, false to stop.

  Example input

  {
    "zip": "zip",
    "enabled": true
  }

  Example response

  {
    "zip": "30318",
    "enabled": true,
    "applies": "overnight"
  }

ToolWhat it doesAccess

• list_billing_statements Returns the recent charges and payments from Billing and payments. read

  Returns recent charges and payments, plus the package type and the last payment. The signed-in user must be an admin of the business account, otherwise Angi hides the page and the call fails.

  MCP callangi_read → list_billing_statements

  REST endpointGET https://cotlet.dev/api/v1/angi/billing-statements

  Parameters

  Parameters: list_billing_statements

  Name	Type	Description
  limit integer	integer	Maximum number of entries to return.

  Example response

  {
    "package": "Pay per lead",
    "last_payment": {
      "date": "2026-10-20",
      "amount": 118,
      "currency": "USD"
    },
    "statements": [
      {
        "date": "2026-10-20",
        "type": "payment",
        "amount": 118
      },
      {
        "date": "2026-10-18",
        "type": "charge",
        "amount": 59
      },
      {
        "date": "2026-10-14",
        "type": "charge",
        "amount": 59
      }
    ]
  }