[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup) # Angi API and MCP server: Let your AI agent work your Angi leads. > Angi has no public API and no MCP server for pros. Its one official connection pushes each new lead as JSON to a CRM webhook, and nothing comes back the other way (checked 28 Oct 2026). Cotlet runs 12 Angi tools on your business account, hosted, over MCP for agents and REST for scripts. Leads, lead credits, reviews and service areas for Angi pros. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST. [MCP setup](https://cotlet.dev/integrations/angi-api-mcp-server.md#connect) [REST API guide](https://cotlet.dev/integrations/angi-api-mcp-server.md#rest-api) - Free 7-day trial, no card - Unofficial, not affiliated with Angi - Page: https://cotlet.dev/integrations/angi-api-mcp-server ## What can you automate in Angi? - Message new leads before other pros do - Keep lead status and notes current - Request credit for invalid leads - Answer homeowner reviews - Ask finished customers for a review - Pause ZIP codes when the crew is booked ## Does Angi have an MCP server or an API? - The lead feed starts from a CRM tile under My business > Integrations, or by email to crmintegrations@angi.com, which vendors say takes 2 to 3 business days. - The Angi app in ChatGPT (since 4 Mar 2026) helps homeowners find a pro. It cannot open a pro's leads. - No official route reads old leads, sends a message, requests a credit or touches reviews. Zapier and n8n have no Angi app. | What you need | CRM webhook | Angi in ChatGPT | Cotlet | |---|---|---|---| | Get new leads out of Angi | Yes, pushed as they arrive | No | Yes, on a schedule | | Read leads from before the setup | No | No | Yes | | Message the homeowner in Angi | No | No | Yes, after your OK | | Request a lead credit | No | No | Yes, after your OK | | Reply to reviews, ask for reviews | No | No | Yes, after your OK | | Works with your own AI agent | Only through your CRM | ChatGPT, homeowner side | Any MCP client | Checked 28 Oct 2026. Sources: [Angi Help: Setting Up Your CRM Integration with Angi](https://intercom.help/angi/en/articles/10288125-setting-up-your-crm-integration-with-angi), [Angi Help: Zapier webhook for leads](https://intercom.help/angi/en/articles/11404595-creating-a-webhook-in-zapier-for-custom-lead-integration-with-angi), [Supergood: Angi API report card](https://supergood.ai/api-report-card/angi), [Angi app in ChatGPT (GlobeNewswire)](https://www.globenewswire.com/news-release/2026/03/04/3249401/0/en/Angi-Launches-the-Angi-App-in-ChatGPT.html) ## How does Cotlet connect to Angi? 1. **Sign in to Angi.** Use your own account in its Cotlet Cloud Browser. 2. **Choose MCP or REST.** Connect your agent or create a Cotlet API key. 3. **Run your workflow.** Ask your agent or send an HTTP request. We never keep your Angi password, and no homeowner message, credit request, review reply or ZIP code change goes out before you approve it. ## Connect Angi to your agent or workflow Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide. 1. **Enable Angi for agents.** Sign up, sign in to your Angi business account in its Cloud Browser, then press Enable for agents. 2. **Add the Cotlet address.** Paste https://cotlet.dev/mcp/v1 into your agent as an MCP server or a custom connector. 3. **Approve the connection.** A chat app opens a Cotlet sign-in to approve. Editors, n8n and scripts use an API key from the console instead. Angi uses the same `https://cotlet.dev/mcp/v1` address as every other app you enable on Cotlet. If you turned Angi on after connecting, refresh the connector so it picks up the new tools. Claude: ``` Settings > Connectors > Add custom connector URL: https://cotlet.dev/mcp/v1/connect Claude Code: claude mcp add --transport http cotlet-angi \ https://cotlet.dev/mcp/v1 \ --header "Authorization: Bearer $COTLET_API_KEY" ``` ChatGPT: ``` Settings > Apps & Connectors > Create MCP server URL: https://cotlet.dev/mcp/v1/connect Authentication: OAuth ``` Cursor: ``` // ~/.cursor/mcp.json { "mcpServers": { "cotlet-angi": { "url": "https://cotlet.dev/mcp/v1", "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" } } } } ``` Codex: ``` # ~/.codex/config.toml [mcp_servers.cotlet-angi] url = "https://cotlet.dev/mcp/v1" bearer_token_env_var = "COTLET_API_KEY" ``` n8n: ``` MCP Client Tool (inside an AI Agent) Transport: HTTP Streamable URL: https://cotlet.dev/mcp/v1 Auth: Bearer, Tool: angi_read ``` Make, Zapier: ``` Make: MCP Client > Call a tool Zapier: MCP Client by Zapier > Run Tool Server URL: https://cotlet.dev/mcp/v1 Token: Tool: angi_write ``` ## How to use the Angi REST API ### Create your Cotlet API key Create a Cotlet API key with access to Angi and its read operations. Store it as `COTLET_API_KEY` in your environment or automation platform's credential store. Connect Angi in Cotlet and enable it for agents. Account access: Your Angi for Pros business account (an admin for billing; the same login as office.angi.com). ### Make your first Angi API request REST: ``` curl https://cotlet.dev/api/v1/angi/leads \ -H "Authorization: Bearer $COTLET_API_KEY" ``` ### Read leads and apply the operation limits A successful REST call puts the tool output in `result`. This illustrative response excerpt omits call IDs, messages and credit details. Illustrative response excerpt: ``` { "status": "success", "app": "angi", "tool": "list_leads", "result": { "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" } ] } } ``` 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. `limit`: Maximum number of leads to return. Lead reads expose a `since` filter without an end-date or cursor input. Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination. ### Angi workflows for agents and automations | Tool | Connect through | Example workflow | |---|---|---| | n8n | HTTP Request | Returns the homeowner and project details of one lead, with your private notes. Use `get_lead` in your configured business report. | | Make | HTTP > Make a request | Returns the homeowner reviews of your business from the Reviews tab. Use `list_reviews` in your configured business report. | | Python or Node.js | REST API | Returns the ZIP codes where you receive leads, and whether each one is on. Use `list_service_locations` in your configured business report. | Send `Authorization: Bearer ` in request headers. You configure the schedule, destination and record comparisons. Cotlet reads Angi; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template. Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports. The [API and MCP reference](https://cotlet.dev/integrations/angi-api-mcp-server.md#tools) lists operations and inputs. The [REST API guide](https://cotlet.dev/docs/api.md) explains authentication, errors and approvals. ## Angi API endpoints and MCP tools ### Leads and messages Every lead in the Leads tab, old ones too, with the homeowner's phone and email. Status, notes and the star rating stay inside your business. - **List leads** (`list_leads`, read): Returns the leads in the Leads tab of your Angi business account, newest first. - **Get a lead** (`get_lead`, read): Returns the homeowner and project details of one lead, with your private notes. - **Message a homeowner** (`send_lead_message`, write, asks first): Sends a message to the homeowner of a lead from the Angi for Pros inbox. - **Set lead status** (`set_lead_status`, write): Sets the status of a lead, the way Set status does in Angi. - **Add a lead note** (`add_lead_note`, write): Adds a private note to a lead, and can rate its quality from 1 to 5 stars. ### Lead credits Angi decides each request within 5 business days. A credit lowers future lead charges and expires after six months. - **Request a lead credit** (`request_lead_credit`, write, asks first): Asks Angi for a credit for a lead you were charged for. ### Reviews Angi holds each reply as pending until its team checks it. Google reviews imported into Angi show in the same list. - **List reviews** (`list_reviews`, read): Returns the homeowner reviews of your business from the Reviews tab. - **Reply to a review** (`reply_to_review`, write, asks first): Adds your public comment to a homeowner review. - **Request a homeowner review** (`request_homeowner_review`, write, asks first): Asks a homeowner for a review, from a lead or by email. ### Service areas ZIP codes only. A change applies overnight; tasks and annual plans change only by phone with Angi. - **List service locations** (`list_service_locations`, read): Returns the ZIP codes where you receive leads, and whether each one is on. - **Turn a service ZIP code on or off** (`update_service_location`, write, asks first): Switches one ZIP code on or off for your lead flow. ### Billing Charges and payments as an admin of the business account sees them. - **List billing statements** (`list_billing_statements`, read): Returns the recent charges and payments from Billing and payments. Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/angi-api-mcp-server#tools ## Who can see my Angi session, and how do I revoke it? - **What we store.** Your signed-in Angi browser profile, AES-256-GCM, in Finland. Never the password. - **What your agent gets.** The 12 Angi tools, nothing else. No cookie, no login. - **What the session sees.** Leads with homeowner contact details, messages, reviews, ZIP codes and, for admins, billing. - **What no tool touches.** Payment method, monthly budget, contract, tasks, profile and password. - **If Angi signs you out.** Your agent gets a link, and you sign in again yourself. - **How to cut access.** Disable for agents, reset the browser or delete the key. The next call fails. cotlet.dev rates A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)). There is no SOC 2 report or outside pentest yet. ## Is it against Angi's terms? Account safety > You agree not to copy/collect Angi content via robots, spiders, scripts, scrapers, crawlers, or any automated or manual equivalent (e.g., by hand). > > [Angi Pro Agreement, Technology Restrictions, 6 Oct 2026](https://legal.angi.com/) The same agreement lets Angi suspend you or end your place in the network "at any time for any reason or no reason at all". The CRM webhook is the one route the agreement names, and auto-responders such as LeadTruffle ride on it. Cotlet works in your login instead, without consent from Angi, so the risk sits with your account. We found no public case of a pro account closed for automation (checked 28 Oct 2026). How we keep your account looking like you: - Your own business account, signed in by you - One Cloud Browser with steady cookies and its own IP - Messages, credit requests, review replies and ZIP changes wait for your OK - No tool changes your budget, payment method or contract - If Angi objects, we pause the Angi tools for everyone within 24 h > Angi shares most leads with several pros, so speed matters, but write each message for the job. A homeowner who gets the same pasted text from you twice will not hire you either. ## What happens when Angi changes? - **12 h** between tests of the Angi reads - **24 h** between tests of writes a homeowner would see - **$0** for a call to an Angi tool paused for a fix The tools work on office.angi.com, the web side of Angi for Pros. When a lead page or the credit form there changes, we update the tool and its name stays the same for your agent. [status.cotlet.dev](https://status.cotlet.dev) checks the site, console and API every 3 minutes. ## Approvals, undo and mistakes 1. **Reads last week's leads.** With phone, ZIP code and the service asked for. 2. **Checks Angi's credit rules.** Under 45 days old, called within 24 h, a listed reason. 3. **Waits for your OK.** Each request shows in your Cotlet console with its reason. 4. **Follows up.** Angi answers within 5 business days; the agent reads the result. | Action | Undo | |---|---| | Message a homeowner | No; they get a text at once | | Request a lead credit | No tool withdraws it; Angi reviews it | | Reply to a review | No edit tool; public once Angi approves it | | Request a homeowner review | No; Angi limits repeats | | Turn a ZIP code on or off | Yes, switch it back; both apply overnight | | Set lead status, add a note | Yes, set it again; only your business sees it | 5 of 12 tools ask first. Status and notes run without asking, since nobody outside your business sees them; so do the 5 reads. Turn the wait off per tool for a scheduled run, such as a first message to every lead at 6:30. > Turning ZIP codes off is the fastest way to stop paid leads, but it takes effect overnight. Leads that arrive before then are still charged. MCP call: ``` { "name": "send_lead_message", "arguments": { "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?" } } ``` REST: ``` curl -X POST https://cotlet.dev/api/v1/angi/leads/lead_8f3a21/message \ -H "Authorization: Bearer $COTLET_API_KEY" \ -H "Content-Type: application/json" \ -d '{"message":"Hi Dana, this is Mike from Summit Roofing. I can look at your roof on Thursday morning. Does 9:00 work?"}' ``` Response: ``` { "lead_id": "lead_8f3a21", "status": "sent", "sent_at": "2026-10-28T08:12:00-04:00" } ``` Scripts and cron jobs reach the same tools over REST at `/api/v1/angi`, with the same key and price. A message to a lead Angi has closed fails and costs nothing. Each tool's REST path is in the tools table. ## How much does the Angi MCP server cost? **About $19 a month** for a pro with about 30 Angi leads a month, 3,360 credits. Lead charges and the membership stay with Angi. | Job | Calls | Credits | |---|---|---| | Check for new leads, twice each weekday | 1 × 44 | 440 | | Read and message each new lead | 2 × 30 | 600 | | Set the status after first contact | 1 × 30 | 300 | | Note and star rating after the call | 1 × 20 | 200 | | Weekly sweep for leads that qualify for credit | 3 × 4 | 120 | | Request a lead credit | 1 × 4 | 40 | | Reply to new reviews, weekly | 2 × 4 | 80 | | Ask a finished customer for a review | 1 × 6 | 60 | | Lead spend report, monthly | 2 × 1 | 20 | | Cloud Browser, 30 days | | 1,500 | | Total | | 3,360 | - Free 7-day trial, no card - 10 credits per successful call, MCP or REST - 50 credits a day for the Cloud Browser - No subscription and no setup fee The month is our example. Angi publishes no lead counts or prices; contractors report $15 to $85 a lead and $300 to $2,500 of spend a month. One credit approved on a $60 lead pays for about three months of the agent. Dollars at the $29 pack rate. ## Angi MCP server on GitHub, auto-responders or hosted: which to use | Option | What it does | Where it stops | |---|---|---| | [chrischall/angi-mcp](https://github.com/chrischall/angi-mcp) | Finds pros by trade and city and reads their ratings and reviews, through your own angi.com tab and a browser extension. | Homeowner side, read only, no Angi account. 0 stars, MIT, last commit 26 Oct 2026. | | [piprads/angi-mcp](https://github.com/piprads/angi-mcp), [markswendsen-code/mcp-angi](https://github.com/markswendsen-code/mcp-angi) | A homeowner demo (search pros, advice, quote request) and a connector with no README. | Neither opens a pro's leads. 0 stars each, last commits Feb and Jun 2026. | | Apify Angi scrapers | Public pro listings, phones and reviews, some also as MCP through Apify. | Other businesses' public pages, not your account; from $0.80 per 1,000 results. | | [LeadTruffle](https://www.leadtruffle.co/angi-autoresponder/), Smith.ai | AI texts, emails or calls to new Angi leads, fed by the CRM webhook. | They reply outside Angi and cannot touch credits or reviews; LeadTruffle quotes after a demo. | | Jobber, ServiceTitan, DripJobs | Copy new Angi leads into your field service app. | One way; status, messages and credits stay in Angi. | If all you need is new leads in your CRM and a quick text from it, the webhook and an auto-responder stay inside what Angi allows. If your agent should also message in Angi, chase lead credits, answer reviews and switch ZIP codes, no other tool reaches those, and Cotlet does it in your own login. ## Who runs Cotlet Cotlet is built by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), in business since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the Angi tools. ## Angi API and MCP: questions ### How do I get access? Create a free account at https://cotlet.dev, choose Angi under Integrations in the console and sign in to your Angi business account in its Cloud Browser. The trial starts right away, with no card. ### How do I connect Angi to ChatGPT or Claude? Sign up at cotlet.dev, log in to Angi once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Angi account through Cotlet, in their phone apps too. ### What can ChatGPT do in Angi? With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Angi: reply to new leads fast; request credit for invalid leads; reply to new reviews. You ask in plain words, and anything that reaches other people waits for your OK first. ### Which leads can I ask Angi to credit? Angi credits a lead only after a review. The lead must be under 45 days old, you must have called the homeowner within 24 hours, your account needs no overdue balance and you cannot have an annual subscription. The reasons Angi lists are invalid contact info, wrong location, service mismatch, duplicate lead and paused leads. A homeowner who never answers or hired someone else does not qualify (Angi Help: How to Request a Lead Credit). ### Can the agent change my services and tasks? No. Angi lets you switch ZIP codes on or off yourself, but tasks (services offered) change only by calling Angi Customer Care, and licensed tasks need license verification (Angi Help: How to View & Update Service Locations & Tasks). ### Does the Angi app in ChatGPT work for pros? No. It answers homeowners' project questions and sends them to Angi to request a pro. It has no access to a business account, its leads or its reviews. ### Can I keep my CRM webhook? Yes. The feed keeps pushing new leads to your CRM, and the agent works on the same leads in Angi: messages, status, credits and reviews. Neither gets in the other's way. ### Is the MCP server different from the REST API? Only in how you call it. Both give the same 12 tools with the same inputs and results, one API key and one price. Agents use MCP; scripts and cron jobs use REST. ### Is Cotlet affiliated with Angi? No. Cotlet is independent and not affiliated with Angi Inc. or HomeAdvisor, Inc. ### Can I use the Angi API without an AI agent? Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST. --- Give your AI agents your signed-in browser. **Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md) **Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet) **Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) **Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md) **Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors) **Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet) Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md) Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.