The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Clutch Agency API listing page.
A company data API for Clutch.co, the B2B directory of agencies and service providers. Walk any category directory, pull full company profiles, and paginate every verified client review, returned as JSON and as LLM-ready markdown. This repo shows two ways to use it: a Python quick start, and Model Context Protocol (MCP) install steps for Claude, Cursor, and ChatGPT.
Actor on Apify Store: Clutch.co Agency API
Get a free Apify API key: https://apify.com?fpr=9n7kx3
This is a company data API for Clutch.co. Pick a mode, give it a URL or a
keyword, and it returns clean rows. In directory mode you pass a Clutch
category page such as https://clutch.co/web-developers and get one row per
company: name, rating, review count, minimum project size, hourly rate, team
size, location, and the profile link, which is how you build a marketing agency
database or a list of digital marketing agencies for a location. In profiles
mode you pass company profile URLs (or bare slugs) and get the full record:
description, founding year, service mix with percentages, industries, client
sizes, pricing bands, and every verified client review as its own row. Every
profile can also carry Clutch's own LLM-ready markdown at no extra cost, which
makes this a good source for shortlisting B2B service providers or feeding a RAG
pipeline. In search mode you pass a keyword and it collects the matching
company profiles for you.
listing rows): name, rating, review count,
verification badges, minimum project size, hourly rate, employees, location,
profile URL.profile rows): everything above plus description,
founding year, all office locations, languages, service lines, focus areas,
industries, client-size split, cost rating, pricing by service, and packages.review rows): title, rating, the quality, schedule,
cost, and willing-to-refer breakdown, project services, budget, duration,
reviewer role and industry, and Clutch's own summaries.This example uses Python with uv. It never uses pip.
.env.example to .env and paste your token
(get one free at https://apify.com?fpr=9n7kx3):| Field | Type | Notes |
|---|---|---|
mode | string | directory (default), profiles, or search. |
directoryUrls | array | Clutch category or location pages, e.g. https://clutch.co/web-developers. |
maxPagesPerDirectory | integer | Result pages per directory URL. Each page is about 70-90 companies. |
profileUrls | array | Company profile URLs, e.g. https://clutch.co/profile/ignite-visibility. A bare slug works. |
searchQueries | array | Free-text queries, e.g. shopify development. |
includeReviews | boolean | Return every verified review as its own row. Default true. |
maxReviewsPerProfile | integer | Cap on reviews per company. |
outputFormats | array | json, markdown (default), and optionally html. |
maxItems | integer | Hard ceiling on rows for the run. Use it as a spend cap. |
The sections below add the Clutch.co Agency API to Claude, Cursor, and ChatGPT as a Model Context Protocol tool, so an assistant can call it directly. The MCP server URL is the same everywhere:
Get a free Apify account at https://apify.com?fpr=9n7kx3 and a token at https://console.apify.com/settings/integrations .

Cowork is the desktop app's automation mode. To give it the Clutch.co Agency API as a tool, add the Apify MCP server as a connector.
claude_desktop_config.json
directly).
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonDownload the desktop app and start a free trial: https://claude.ai/referral/uIlpa7nPLg More help: https://docs.apify.com/platform/integrations/claude-desktop

Claude Code is the command-line tool. Add the Actor's MCP server with one command:
To use a token instead of browser OAuth:
Then verify with claude mcp list, or run /mcp inside a session. Ask Claude
Code to call the Clutch.co Agency API.
Try Claude Code free: https://claude.ai/referral/uIlpa7nPLg Claude Code MCP docs: https://code.claude.com/docs/en/mcp

On claude.ai you add Apify as a connector, then enable just this Actor's tool.
johnvc/clutch-agency-api.https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api, using
OAuth when prompted.Open Claude on the web: https://claude.ai

Cursor reads MCP servers from a project file at .cursor/mcp.json.
.cursor/mcp.json:New to Cursor? Get it here: https://cursor.com/referral?code=XQP4VBLI3NNX

ChatGPT connects to the Apify MCP server through Developer mode (available on ChatGPT Pro, Plus, Business, Enterprise, and Education plans).
https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-apiMore help: https://docs.apify.com/platform/integrations/mcp
Open a ready-to-send prompt about the Clutch.co Agency API in the AI of your choice:
Is this a company data API? Yes. It returns structured company records from Clutch.co: firmographics, service mix, pricing bands, ratings, and verified reviews, as JSON you can drop into a CRM or a vector store.
Can I use it as a B2B directory? Yes. Directory mode reads any Clutch category or location page and returns one row per listed company, which is a ready-made B2B directory export.
Can I build a marketing agency database? Yes. Point directory mode at a marketing category, page through the results, and you get a marketing agency database with ratings, rates, and locations.
Does it get client reviews? Yes. In profiles and search modes, every verified client review comes back as its own row, paginated until the company's declared total is reached.
Do I need a Clutch.co account or API key? No. There is nothing to configure on Clutch's side. You only need an Apify API token to run the Actor. Get one free at https://apify.com?fpr=9n7kx3 .
Last Updated: 2026.09.28