Summary
Connects Claude to ServiceGraph's business datasets: agencies, product directories, newsletters, and business directories, all filterable by metrics like domain rating, traffic, size, and location. The generic `servicegraph` skill discovers schemas and searches across any dataset, while specialized skills like `find-marketing-agency` or `find-web-developer` auto-pin filters for US professional services firms. Free browsing and brief cards, credits unlock full contact details and enrichment. Runs on streamable HTTP at mcp.servicegraph.co. You'd reach for this when prospecting launch venues, building outreach lists, or researching service providers without manually scraping directories. Requires an API key from servicegraph.co with 2,000 free credits on signup.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
6 tools
list_tagsReturns the catalog of fields, kinds, operators, and (optionally) value lists that the filter DSL accepts. Call this once per session to discover what you can query. Use include_values=true to expand the value list for every field; pass q to filter by name/description substring.2 params
Returns the catalog of fields, kinds, operators, and (optionally) value lists that the filter DSL accepts. Call this once per session to discover what you can query. Use include_values=true to expand the value list for every field; pass q to filter by name/description substring.
Parameters* required
qstringSubstring filter on field name or description.
include_valuesbooleanExpand the legal value list for every field (slower).
check_filterValidates a filter DSL string without executing it. Returns {valid, normalized, tables_used, param_count} on success or {valid:false, error:{code,message,position}} on parse error. Cheap; use it before search_firms / explore_firms to sanity-check generated filters.1 params
Validates a filter DSL string without executing it. Returns {valid, normalized, tables_used, param_count} on success or {valid:false, error:{code,message,position}} on parse error. Cheap; use it before search_firms / explore_firms to sanity-check generated filters.
Parameters* required
filterstringDSL filter string, e.g. "industry:legal state:CA"
explore_firmsCounts and per-facet breakdowns for the catalog under a filter. Use this BEFORE search_firms to size the query and choose narrowing facets. Does not return any individual firms and does not consume monthly quota. When the filtered set has fewer than 20 firms, breakdowns are su...1 params
Counts and per-facet breakdowns for the catalog under a filter. Use this BEFORE search_firms to size the query and choose narrowing facets. Does not return any individual firms and does not consume monthly quota. When the filtered set has fewer than 20 firms, breakdowns are su...
Parameters* required
filterstringFilter DSL string. Empty = whole catalog.
search_firmsReturns brief firm cards under a filter DSL. Costs against the calling user's monthly unique-firm-view quota; re-pages and overlapping queries are free for the overlap. Brief cards do NOT include apex, url, phone, email, or address — call get_firm with the firm_id from a searc...4 params
Returns brief firm cards under a filter DSL. Costs against the calling user's monthly unique-firm-view quota; re-pages and overlapping queries are free for the overlap. Brief cards do NOT include apex, url, phone, email, or address — call get_firm with the firm_id from a searc...
Parameters* required
limitintegerMax number of brief cards to return.default: 20
filterstringFilter DSL string. Required.
offsetintegerdefault: 0
order_bystringone of
relevance · facet_confidence · randomdefault: relevanceget_firmReturns the full disclosure bundle (apex, url, phone, email, social, legal name, address) for a single firm by firm_id. firm_id is sha256(apex.lower().rstrip(".")).hexdigest()[:12]. Costs 1 against the monthly /get quota the first time a firm is fetched in a calendar month; re...1 params
Returns the full disclosure bundle (apex, url, phone, email, social, legal name, address) for a single firm by firm_id. firm_id is sha256(apex.lower().rstrip(".")).hexdigest()[:12]. Costs 1 against the monthly /get quota the first time a firm is fetched in a calendar month; re...
Parameters* required
firm_idstring12 lowercase-hex firm_id from a search result.
catalog_statsTop-level catalog statistics — total firm count, per-industry breakdowns, coverage percentages for facets and contact info. Use this for "what's in the catalog overall" rather than to find specific firms.
Top-level catalog statistics — total firm count, per-industry breakdowns, coverage percentages for facets and contact info. Use this for "what's in the catalog overall" rather than to find specific firms.
No parameter schema in public metadata yet.
ServiceGraph Agent Skills
Datasets for founders — where to launch, who to email, who to hire.
Agent Skills for ServiceGraph — structured, metrics-enriched business datasets your agent can filter, rank, and pull contact data from. One filter DSL, one credit balance, many datasets:
| Dataset | Size | Enriched with |
|---|---|---|
| Agencies (US professional-services firms) | 110k+ | services · size · location · ratings |
| Business directories | 3,500+ | industry · domain rating · traffic |
| Product directories | 850+ | submission policy · domain rating · traffic |
| Newsletters | 50k+ | subscribers · topics · post cadence |
| subreddits, influencers | coming soon |
The branded servicegraph skill works against every dataset — say
"servicegraph" and your agent discovers what datasets exist, learns each
one's schema and filters, searches free, and unlocks detail with credits.
The specific find-* skills cover two datasets today. For the Agencies
dataset — law, marketing, design, consulting, accounting, IT services, AI/ML,
web development, engineering, HR, PR, cybersecurity, and more — filterable by
industry, services, location, size, ratings, and third-party listings. And for
the Product directories dataset — where to launch a software product and
earn backlinks — covering general product/SaaS launches, MCP-server
registries, and AI-tool / AI-agent / agent-skill directories, ranked by Domain
Rating and organic traffic. More per-use-case skills for the newsletter and
other datasets land here as they ship — same install, same API key, same DSL.
Compatible with 19+ AI agents including Claude Code, Codex, Cursor, GitHub Copilot, Gemini, Cline, Goose, Windsurf, and any other harness that supports the Agent Skills format.
Installation
Install a specific skill
npx skills add nostrband/servicegraph --skill find-service-providers
Install all skills
npx skills add nostrband/servicegraph
API key: browsing, filtering, and brief cards are free, but every call
needs a key. Create one at
servicegraph.co/profile/api-keys
(2,000 free credits on signup, no card) and put it in your shell or
.env.local as SERVICEGRAPH_API_KEY=vk_…. Skills prompt for it on first
use and never read the value into the model's context.
Available Skills
Any dataset
servicegraph — the branded entry point
The generic, dataset-agnostic way to drive ServiceGraph. Launch it by naming the brand; it discovers what datasets exist and each one's schema and filters through the API, searches free brief rows, and unlocks contact + metric detail with credits — no datasets or fields hardcoded, so it stays correct as new data lands.
Use when:
- "Use ServiceGraph to find …"
- "What datasets does ServiceGraph have?"
- "Search ServiceGraph for … / look this up in ServiceGraph"
- "Pull contacts from ServiceGraph for these domains"
- The dataset you need has no specific skill below yet
Agencies dataset
find-service-providers — the umbrella skill
Find, shortlist, vet, or enrich US professional-services firms across all 22 industries in the catalog — law, marketing, consulting, accounting, IT services, architecture, engineering, HR, PR, design, and more.
Use when:
- "Find me three boutique IP law firms in California"
- "Build a longlist of 50 mid-size US management consultancies"
- "Here are 12 agency domains — pull contact info and confirm which are US-based"
- The user's intent doesn't fit a more specific skill below
find-marketing-agency
Find US marketing agencies — branding, content marketing, PPC/paid media,
social, email, performance/demand-gen, video production, full-service digital.
Auto-pins industry:marketing_agency so the agent doesn't have to.
Use when:
- "Shortlist three B2B branding agencies in California"
- "Find a PPC shop with ecommerce experience"
- "We need a content marketing partner for a SaaS launch"
find-seo-agency
Find US SEO agencies — technical, on-page/off-page, link-building,
content-led, local, ecommerce, B2B SEO, audits. Auto-pins
industry:marketing_agency service_provided:seo.
Use when:
- "Find me an SEO agency in Texas"
- "Shortlist three technical SEO consultancies for SaaS"
- Indirect phrasings: "organic traffic is flat", "improve our Google rankings"
find-design-agency
Find US design and creative agencies — graphic design, UX/UI, product
design, brand identity, packaging, illustration, motion design, creative
direction. Auto-pins industry:design_creative. Defers to
find-marketing-agency for marketing-led engagements where design is one
of several services, and to find-web-developer when the deliverable is a
built website rather than design assets.
Use when:
- "Find me a UX/UI design agency for our SaaS product"
- "Shortlist three brand-identity studios in NY for our rebrand"
- "Packaging design firm for a CPG launch"
find-software-developer
Find US software development firms — custom software, web/mobile development,
backend/API, DevOps/cloud consulting, system integration, hosting. Auto-pins
industry:it_services. Defers to find-web-developer for strictly
website/landing-page projects, and to find-ai-consultancy for AI/ML
modeling and data-engineering work.
Use when:
- "Find me a software dev shop in Austin"
- "Shortlist three custom-software firms with healthcare experience"
- "We need a mobile app developer for our iOS launch"
find-web-developer
Find US web development firms — building, refreshing, or rebuilding
marketing sites, landing pages, ecommerce, WordPress/Webflow/Shopify,
headless CMS, microsites, and web frontend work. Auto-pins
industry:it_services service_provided:web-development. Defers to
find-software-developer for backend/API/mobile work, and to
find-marketing-agency when scope spans broader marketing.
Use when:
- "Find a web developer for our marketing landing page"
- "Shortlist three Webflow agencies in California"
- "Rebuild our ecommerce site on Shopify with custom theme work"
find-ai-consultancy
Find US AI/ML and data consulting firms — AI/ML development, MLOps,
generative AI / LLM apps (RAG, chatbots, agents), computer vision, NLP,
recommendation systems, data engineering, BI/analytics. Auto-pins
industry:data_ai_consulting. Defers to find-software-developer for
general app/backend work where AI is just a feature.
Use when:
- "Find an AI/ML consulting firm to build our recommendation engine"
- "Three RAG/LLM consultancies for an enterprise chatbot project"
- Indirect: "we want to use AI to predict customer churn — who can help?"
find-law-firm
Find US B2B law firms — corporate, IP/patent, M&A and securities,
employment, commercial litigation, regulatory/compliance, data privacy/
cyber, real estate, tax. Auto-pins industry:legal. The catalog is
B2B-only — consumer-personal matters (divorce, personal injury, criminal
defense, estate planning, family law, wills) are explicitly out of scope.
Use when:
- "Find three boutique IP law firms in California for patent prosecution"
- "Shortlist M&A counsel for a Series-B fundraise"
- Indirect: "outside counsel for GDPR / SOC 2 oversight"
find-cpa-firm
Find US accounting and tax firms (CPA firms) — financial-statement audit,
SOC 1/2, corporate tax, bookkeeping for businesses, advisory/fractional
CFO, M&A diligence, 409A valuations, R&D tax credits, IPO readiness,
sales-and-use tax. Auto-pins industry:accounting_tax. B2B-only —
personal tax prep (1040, individual estate, retirement planning) is
out of scope.
Use when:
- "Find me a CPA firm for our Delaware C-corp Series A audit"
- "Shortlist three audit firms with SaaS experience"
- Indirect: "our books are a mess and we need someone to clean them up before the audit"
find-management-consultant
Find US management consultancies — strategy, operations, executive
coaching, leadership development, org-development/change management,
PMO/program management, sales/revenue ops. Auto-pins
industry:management_consulting and uses the service_provided
sub-tags (strategy-consulting, operations-consulting, etc.).
Use when:
- "Find me three top strategy consultancies in California for a Series-B SaaS"
- "We need an executive coach for our new CEO"
- Indirect: "change-management partners for a post-merger integration"
find-engineering-firm
Find US real-world engineering firms — civil, structural, MEP,
mechanical, electrical, geotechnical, transportation, environmental,
manufacturing. Auto-pins industry:engineering_services. NOT for
software engineering — defers software-dev / "engineering team" /
SaaS-architecture asks to find-software-developer. Skips residential
or consumer architecture asks.
Use when:
- "Find civil engineering firms in Florida for transportation infrastructure"
- "Shortlist three structural engineering firms with high-rise experience"
- Indirect: "we're building a 10-story office and need a structural engineer to stamp the drawings"
find-recruiting-firm
Find US recruiting and staffing firms — executive search/retained search,
RPO, tech/sales/healthcare recruiting, contingent/contract staffing, temp
staffing. Auto-pins industry:hr_recruiting_staffing. Procures an
external recruiting firm — does NOT fire on recruiting-an-employee
asks ("hire a recruiter for our team", "where should I post the job"),
candidate-side asks, or in-house recruiter hires.
Use when:
- "Find me an executive search firm for a CFO search"
- "We need RPO support for a 50-engineer hiring push"
- Indirect: "we're scaling fast and need help hiring at scale"
find-pr-agency
Find US public-relations and communications agencies — media relations,
crisis comms, investor relations (IR), product-launch PR, tech/startup
PR, healthcare PR, B2B PR, public affairs, brand reputation, internal
communications. Pins service_provided:public-relations. Defers to
find-marketing-agency when scope spans broader marketing beyond
PR/comms.
Use when:
- "Find me a tech PR agency in NY for our Series-B announcement"
- "Three IR firms for our upcoming IPO roadshow"
- Indirect: "we need press — get us into TechCrunch, WSJ, the trade press"
find-cybersecurity-firm
Find US cybersecurity firms — pen-testing/red team, security audits,
vCISO, SOC 2 readiness, incident response, managed SOC, IAM, cloud
security, AppSec. Pins service_provided:cybersecurity. B2B-only
— consumer-personal cybersecurity ("my Gmail got hacked", "secure my
home wifi") is out of scope.
Use when:
- "Find me a pen-testing firm for our SOC 2 audit"
- "We need an incident response retainer"
- Indirect: "we got hit with ransomware last week — we need help fast"
Product directories dataset
Each row is a directory you submit to — not a firm and not a product. These skills answer where to launch a software product and earn backlinks: they rank listing sites by Domain Rating (free in every result, so you shortlist for zero credits) and unlock the submission note (how to submit, and whether the listing grants a backlink) plus organic traffic with credits. Global catalog, not US-only.
find-product-directories — the umbrella
Find and rank directories to submit a SaaS, software product, app, or
startup to — SaaS review sites, launch platforms (Product Hunt and its
alternatives), and general software directories. Defers to
find-mcp-directories and find-ai-directories for those niches.
Use when:
- "Where can I submit my B2B SaaS to get backlinks and launch-day traffic?"
- "Give me a list of Product Hunt alternatives to launch our app on"
- "Here are 10 software directory domains — pull submission details and rank by DR"
find-mcp-directories
Find and rank MCP-server registries (Model Context Protocol) — where to publish a server so agent builders discover it, ranked by domain authority.
Use when:
- "Where do I list my MCP server?"
- "Best MCP directories and registries to submit our server to for backlinks"
- Indirect: "we just built an MCP server — where do we publish it?"
find-ai-directories
Find and rank directories for AI tools, AI agents, and agent skills /
plugins — where to list an AI product for backlinks and discovery. Defers to
find-mcp-directories when the artifact is specifically an MCP server.
Use when:
- "Where can I list my AI tool to get backlinks and discovery?"
- "Directories to submit my AI agent / where do I publish our agent skill?"
- "Rank the top AI tool directories by domain rating for our SEO push"
Prefer MCP? Use the hosted server.
If your harness speaks the Model Context Protocol, skip the skill install and point it at the hosted MCP server:
https://mcp.servicegraph.co
- Transport: Streamable HTTP
- Auth: OAuth 2.1 + PKCE with Dynamic Client Registration — your harness
opens a browser tab on first use; you sign in on
servicegraph.coand are bounced back. No client ID or secret to copy around, no API key to paste.
Claude Code
claude mcp add --transport http servicegraph https://mcp.servicegraph.co
Claude Desktop
Settings → Connectors → Add custom connector, then paste:
https://mcp.servicegraph.co
The OAuth handshake runs in your browser on first use.
Codex CLI
~/.codex/config.toml:
[mcp_servers.servicegraph]
url = "https://mcp.servicegraph.co"
Cursor and other JSON-config clients
.cursor/mcp.json (or the equivalent for your harness):
{
"mcpServers": {
"servicegraph": {
"url": "https://mcp.servicegraph.co"
}
}
}
Usage
Skills are automatically available once installed. The agent will pick the right one when it detects a relevant task.
Examples:
Find me three boutique IP law firms in California that handle patent
prosecution for hardware startups.
Need a shortlist of mid-size SEO agencies in NY or NJ with a strong B2B
SaaS portfolio.
We're hiring a CPA firm for a Delaware C-corp Series A audit.
Recommend 5 options under 50 people.
Here are 12 marketing agency domains I scraped — pull contact info and
confirm which are in the US.
How it works — browse free, unlock with credits
Every dataset lives behind the same per-dataset URL shape and the same
filter DSL. For the agencies dataset the id is pro_services:
GET /v1/datasets/pro_services/fields → field catalog + DSL grammar · free
GET /v1/datasets/pro_services/check → validate a filter · free
GET /v1/datasets/pro_services/search → brief firm cards · free
GET /v1/datasets/pro_services/{apex} → one row (brief; detail if unlocked) · free
POST /v1/datasets/pro_services/unlocks → full contact bundle · 10 credits/row
Discovery, filtering, and brief cards are free — you only spend credits to unlock a row's full contact detail (URL, phone, email, social, address). An unlock lasts 30 days and re-fetching within that window is free.
- 2,000 free credits on signup, no card.
- 10 credits per row (~$0.10). Top-ups: $10 / 1,000 credits, $80 / 10,000 (20% off). Credits never expire.
Filter DSL
One query parameter, GitHub-search-style. AND binds tighter than OR;
-x / NOT x for negation; tag@evidence for the service_provided field.
Any bareword is a free-text keyword search across firm name, brand, title,
meta description, and legal name.
industry:legal state:CA,NY -company_size_signal:solo
industry:management_consulting service_provided:strategy-consulting@high
dental industry:marketing_agency
rating>=4 review_count_total>=20 has:clutch
(web3 OR blockchain) state:CA
The field catalog (kinds, operators, allowed values) is discoverable at
runtime via
/v1/datasets/pro_services/fields.
Why structured beats search
- Filter, don't grep. Industry, services, location, size, rating, domain authority, traffic, third-party listings — all queryable as a single filter string, not a wall of fuzzy web results.
- Metrics built in. Every row carries the signals you'd otherwise scrape by hand — agency ratings, directory DR/traffic, newsletter subscriber counts — so an agent can rank, not just list.
- Cheaper than scraping. Browse and filter for free; pay only for the contact rows you actually want, ~$0.10 each, 30-day access, credits never expire. Beats Google, ChatGPT guesses, and stale Notion/Twitter lists.
Skill structure
Each skill follows the Agent Skills Open Standard:
SKILL.md— required manifest with frontmatter (name, description, metadata)
The skills in this repo are single-file. No bundled scripts or references yet — the API is small enough that the agent does fine with prose + copy-pasteable curl examples.
Links
Community
See also
License
MIT
Contact
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →