---
slug: "servicegraph"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/nostrband/servicegraph@main/README.md"
repo: "https://github.com/nostrband/servicegraph"
source_file: "README.md"
branch: "main"
---
# ServiceGraph Agent Skills
> **Datasets for founders** — where to launch, who to email, who to hire.
Agent Skills for [**ServiceGraph**](https://servicegraph.co) — 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](https://agentskills.io/) format.
## Installation
### Install a specific skill
```bash
npx skills add nostrband/servicegraph --skill find-service-providers
```
### Install all skills
```bash
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**](https://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](https://modelcontextprotocol.io/),
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
```bash
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`:
```toml
[mcp_servers.servicegraph]
url = "https://mcp.servicegraph.co"
```
### Cursor and other JSON-config clients
`.cursor/mcp.json` (or the equivalent for your harness):
```json
{
"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`](https://api.servicegraph.co/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](https://agentskills.io/):
- `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](https://docs.servicegraph.co)
- [OpenAPI 3.1 spec](https://api.servicegraph.co/openapi.json)
- [Create an API key](https://servicegraph.co/profile/api-keys)
- [llms.txt](https://servicegraph.co/llms.txt)
- [Site](https://servicegraph.co)
## Community
- [Dev.to](https://dev.to/brugeman)
- [X.com](https://x.com/briugemanai)
## See also
- [Product directories](https://servicegraph.co/product-directories)
- [MCP directories](https://servicegraph.co/blog/best-mcp-directories-2026)
- [Agent skills directories](https://dev.to/brugeman/where-to-publish-your-ai-agent-skills-discovery-hubs-and-directories-5l7)
- [ProductHunt](https://www.producthunt.com/@arturbrugeman)
## License
MIT
## Contact
[artur@servicegraph.co](mailto:artur@servicegraph.co)