ServiceGraph Agent Skills

Stop scraping. Your agent's directory of US service firms is here.

Agent Skills for ServiceGraph — a structuredcatalog of 100k+ US professional-services firms (law, marketing,consulting, accounting, IT services, architecture, engineering, HR, PR,design) with filters for industry, services offered, location, size, ratings,and third-party listing presence.

Compatible with 19+ AI agents including Claude Code, Codex, Cursor, GitHubCopilot, Gemini, Cline, Goose, Windsurf, and any other harness that supportsthe 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

No signup is needed for catalog discovery (/v1/tags, /v1/check,/v1/explore). Skills prompt the user for an email + one-time code only whenthey reach the contact-info tier (/v1/search, /v1/get).

Available Skills

find-service-providers — the umbrella skill

Find, shortlist, vet, or enrich US professional-services firms across all 22industries in the catalog — law, marketing, consulting, accounting, ITservices, 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-pinsindustry: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-software-developer

Find US software development firms — custom software, web/mobile development,backend/API, DevOps/cloud consulting, system integration, hosting. Auto-pinsindustry:it_services. Defers to find-web-developer for strictlywebsite/landing-page projects, and to dedicated AI/ML routes formodeling-only 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 rebuildingwebsites: marketing sites, landing pages, ecommerce, WordPress/Webflow/Shopify, headless CMS, microsites, web frontend. Auto-pinsindustry:it_services service_provided:web-development. Defers tofind-software-developer for backend/API/mobile work, and tofind-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-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 isB2B-only — consumer-personal matters (divorce, personal injury, criminaldefense, 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/fractionalCFO, 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) isout 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 upbefore the audit"

find-management-consultant

Find US management consultancies — strategy, operations, executivecoaching, leadership development, org-development/change management,PMO/program management, sales/revenue ops. Auto-pinsindustry:management_consulting and uses the service_providedsub-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-recruiting-firm

Find US recruiting and staffing firms — executive search/retained search,RPO, tech/sales/healthcare recruiting, contingent/contract staffing, tempstaffing. Auto-pins industry:hr_recruiting_staffing. Procures anexternal recruiting firm — does NOT fire on recruiting-an-employeeasks ("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/startupPR, healthcare PR, B2B PR, public affairs, brand reputation, internalcommunications. Auto-pins industry:pr_comms. Defers tofind-marketing-agency when scope spans broader marketing beyondPR/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, cloudsecurity, AppSec. Auto-pins the cybersecurity industry tag. B2B-only— consumer-personal cybersecurity ("my Gmail got hacked", "secure myhome 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"

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 — yourharness opens a browser tab on first use; the user enters their email +one-time code on api.servicegraph.co and is bounced back. No clientID or secret to copy around.

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 theright 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 — the four-tier funnel

GET /v1/tags         →  field catalog · free · anonymous
GET /v1/check        →  validate filter · free · anonymous
GET /v1/explore      →  counts + breakdowns · free · anonymous
GET /v1/search       →  brief firm cards · 200/month free
GET /v1/get/{id}     →  full bundle (url, phone, email) · 50/month free

Skills know to walk down the funnel: cheap tiers first, expensive tiers onlyon shortlisted firms. Re-pages and overlapping queries are free — the quotacounts only unique firm-views per calendar month.

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

Field catalog (kinds, operators, allowed values) is discoverable at runtimevia /v1/tags.

Why structured beats search

Filter, don't grep. Industry, services, location, size, rating,third-party listings — all queryable as a single filter string. Not a wallof fuzzy web results.
Try before you sign up. /v1/explore is fully anonymous. Get countsand breakdowns for any filter to size the candidate pool before spending anAPI call.
Quota rewards focus. 200 unique firm-views per month free. Re-pagingor overlapping queries are free; only new firms count.

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 referencesyet — the API is small enough that the agent does fine with prose +copy-pasteable curl examples.

License

MIT

Contact

[email protected]

ServiceGraph Agent Skills