How do I install Angi?

Angi is a local plugin. Install it using npm package: @chrischall/angi-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Yes. Angi passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Angi need?

Angi requires the following credentials or environment variables: ANGI_WS_PORT, ANGI_DEBUG, FETCHPROXY_WS_HOST, FETCHPROXY_IDENTITY_DIR. You can find setup instructions on the server detail page.

What AI apps work with Angi?

Angi uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Angi MCP Server

by Chris Hall

Developer ToolsLow Risk10.0Local

Free

Angi for Claude — find home-service pros by trade and city, read ratings and reviews

About

Angi for Claude — find home-service pros by trade and city, read ratings and reviews

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (2 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (73/74 approved); 5 highly-trusted packages.

5 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Override the fetchproxy WebSocket port (default 37149).Optional

Environment variable: ANGI_WS_PORT

Set to 1 for verbose bridge logging to stderr.Optional

Environment variable: ANGI_DEBUG

Bind interface for the fetchproxy concentrator (default 127.0.0.1; a literal IP only). For a hosted child in its own network namespace only — never bind a laptop's concentrator to the network.Optional

Environment variable: FETCHPROXY_WS_HOST

Absolute path where fetchproxy stores its long-term identity keypair (default ~/.fetchproxy/identity/). For a host that runs a separate child per caller, so they share one identity.Optional

Environment variable: FETCHPROXY_IDENTITY_DIR

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-chrischall-angi-mcp": {
      "env": {
        "ANGI_WS_PORT": "your-angi-ws-port-here"
      },
      "args": [
        "-y",
        "@chrischall/angi-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

angi-mcp

MCP server for Angi (formerly Angie's List) — find home-service pros by trade and city, and read their ratings, profiles and reviews.

Angi serves its pages only to a real browser, so requests route through the user's own angi.com tab via the ContextMint Bridge browser extension (fetchproxy protocol), reusing their existing session. The trade/city taxonomy is read directly from Angi's public sitemaps and needs no browser at all.

No Angi account or credentials are required. Everything this server reads is public.

This project was developed and is maintained by AI (Claude). Use at your own discretion.

Install

npm install -g @chrischall/angi-mcp

{
  "mcpServers": {
    "angi": { "command": "angi-mcp" }
  }
}

You also need the ContextMint Bridge browser extension, with an open angi.com tab and its site access allowing angi.com. Install it from the ContextMint Bridge releases: unzip the Chrome build and load it via chrome://extensions → Load unpacked. Safari isn't available yet (it will ship inside the ContextMint app, which has no public download), so use Chrome for now. On the first request the extension shows a pairing code to approve; the trust then persists.

ContextMint Bridge is the fetchproxy browser extension under its new name, from the same maintainer — fetchproxy's own README (https://github.com/chrischall/fetchproxy#extension) points to it. Its source is public at https://github.com/nullnet-app/contextmint-bridge: build it yourself, or check a release zip against the .sha256 file published beside it (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256).

Run angi_healthcheck to confirm the bridge is connected.

Tools

Tool	What it does
`angi_search_pros`	Pros for a trade in a US city, with ratings, review counts, years in business, service area, amenities. 10 per page.
`angi_get_pro`	One pro's full profile and ratings breakdown.
`angi_get_reviews`	Reviews on a pro's profile — rating, text, reported cost, date, categories, the pro's response. Filterable by rating.
`angi_list_trades`	Every trade slug Angi publishes (~312). No bridge needed.
`angi_list_cities`	Cities Angi publishes pages for, per trade. No bridge needed.
`angi_healthcheck`	Bridge connection state.

Signed-in tools (need the browser tab signed in to Angi):

Tool	What it does
`angi_get_account`	Your name, email and open/closed project counts.
`angi_list_my_projects`	Your Angi projects, open and closed.
`angi_list_my_reviews`	Reviews you've written, plus pros awaiting a rating.

Searches take slugs, not free text — resolve them first:

angi_list_trades   { contains: "duct" }      -> "air-duct-cleaning"
angi_list_cities   { trade: "plumbing", state: "nc", contains: "char" }
angi_search_pros   { trade: "plumbing", state: "nc", city: "charlotte" }

angi_search_pros, angi_get_pro and angi_get_reviews answer in the slim view: "compact" projection by default; pass view: "full" for Angi's whole ~1KB records. (The old compact boolean still works as a deprecated alias and will be removed in a later release.)

Ratings

Each pro carries two overall ratings and they differ on purpose:

rating (averageRatings.OVERALL) — unrounded. Rank on this.
displayRating (averageOverallRating) — the rounded value Angi shows.

Per-dimension ratings (quality, value, punctuality, professionalism, responsiveness) come through in the full record.

isSponsored: true marks paid placement, not a quality signal.

Limits

No zip-code filtering. Angi's ?zip= parameter is inert — a Charlotte URL returns Charlotte pros regardless. Location comes from the city slug.
Account record shapes are unverified. The account used to map my.angi.com held zero projects and zero reviews, so only the envelopes were observed. angi_list_my_projects and angi_list_my_reviews return records raw and set recordFieldsVerified: false rather than projecting onto field names nobody has seen. See docs/ANGI-API.md.
The inbox is not readable. Angi's messages run on the Twilio Conversations SDK; the proxy endpoints reject the session cookie alone (401), so messages need the Twilio client rather than an HTTP GET.
Cannot be hosted remotely. Like every browser-bridge server in this fleet, it needs a signed-in tab on the machine it runs on, so it cannot be served to claude.ai from mcp-host.

Without the MCP

skills/angi-fpx/ is a shell-out skill that reads the same data with the fpx CLI and no running server — useful in scripts or on a machine where the MCP isn't installed.

Development

npm install
npm run build      # tsc --noEmit + esbuild bundle
npm test

docs/ANGI-API.md records the live-captured request/response shapes, including the verified negative results. Read it before changing src/parse.ts.