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:

The skills in this repo cover the Agencies dataset today — 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. Skills for the directory, 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 (Agencies dataset)

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 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 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 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 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 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 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 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 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 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 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 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 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 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"

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.co and 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

• API console & docs

• OpenAPI 3.1 spec

• Create an API key

• llms.txt

• Site

Community

• Dev.to

• X.com

See also

• Product directories

License

MIT

Contact

artur@servicegraph.co