Find Law Firm

What it does

When your agent uses it

• The user wants to find
• Enrich US B2B law firms — corporate
• M&A and securities
• Commercial litigation

Example prompts

• “find three boutique IP law firms in California”
• “shortlist M&A counsel for a Series-B fundraise”
• “patent prosecution for our hardware startup”
• “/find-law-firm”

Requirements

• A credential in SERVICEGRAPH_API_KEY
• Compatibility (from SKILL.md): Designed for Claude Code
• Pre-approved tools (allowed-tools): Bash(curl:*), mcp__servicegraph__list_fields, mcp__servicegraph__list_field_values, mcp__servicegraph__check_filter, mcp__servicegraph__translate_intent, mcp__servicegraph__search_dataset, mcp__servicegraph__get_row, mcp__servicegraph__unlock_rows, mcp__servicegraph__get_credit_balance

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1Pick the call path — the ServiceGraph MCP tools if loaded, otherwise the
2. 2GET /v1/datasets/pro_services/fields?include_values=1 — confirm the
3. 3Build the filter (Filter DSL below) and validate it with
4. 4GET /v1/datasets/pro_services/search — present the free brief cards and
5. 5Quote the unlock cost (10 credits per row, 30-day TTL) and get an explicit
6. 6POST /v1/datasets/pro_services/unlocks with the chosen apexes; report the
7. 7GET /v1/me/credits to report the remaining balance when asked.

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(curl:*)
  • mcp__servicegraph__list_fields
  • mcp__servicegraph__list_field_values
  • mcp__servicegraph__check_filter
  • mcp__servicegraph__translate_intent
  • mcp__servicegraph__search_dataset
  • mcp__servicegraph__get_row
  • mcp__servicegraph__unlock_rows
  • mcp__servicegraph__get_credit_balance

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • curl

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • api.servicegraph.co
  • mcp.servicegraph.co

  Also links to:

  • servicegraph.co
  • github.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • SERVICEGRAPH_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Designed for Claude Code

  From compatibility in the SKILL.md frontmatter.

Context cost

Find Law Firm loads about 3.6k tokens when it runs. Until then it costs about 240 tokens; SKILL.md has 1,259 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~240

When it runs · the whole SKILL.md, loaded when a task matches

~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:65

  ICEGRAPH_API_KEY` in the environment or `.env.local` for the REST

• NoteMentions a .env fileSKILL.md:121

  LLM context** — never read `.env*` into your context; dispatch via

• NoteMentions a .env fileSKILL.md:124

  ** through a shell wrapper that sources `.env.local`:

• NoteMentions a .env fileSKILL.md:127

  ( set -a; [ -f .env.local ] && . ./.env.local; set +a;

• NoteMentions a .env fileSKILL.md:135

  and add `SERVICEGRAPH_API_KEY=vk_…` to `.env.local` here

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 1,259 words, ~3,605 tokens.

name

find-law-firm

description

Use whenever the user wants to find, shortlist, vet, or enrich US B2B law firms — corporate, IP/patent, M&A and securities, employment, commercial litigation, regulatory/compliance, data privacy/cyber, real estate, and tax. Triggers on "find three boutique IP law firms in California", "shortlist M&A counsel for a Series-B fundraise", "patent prosecution for our hardware startup", or "pull contact info for these 10 law firm domains", even when described indirectly (outside counsel, cap-table review, GDPR/SOC2 oversight). Drives the ServiceGraph API (api.servicegraph.co) — a 100k+ US firm catalog filterable by industry, services, location, size, ratings. Skip personal/consumer legal services where the user is the end client (divorce, personal injury, criminal defense, family law, estate planning, wills) — the catalog is B2B-only. Also skip in-house GC hires, "is this NDA enforceable" DIY questions, non-US firms, individual freelancers.

allowed-tools

Bash(curl:*), mcp__servicegraph__list_fields, mcp__servicegraph__list_field_values, mcp__servicegraph__check_filter, mcp__servicegraph__translate_intent, mcp__servicegraph__search_dataset, mcp__servicegraph__get_row, mcp__servicegraph__unlock_rows, mcp__servicegraph__get_credit_balance

compatibility

Designed for Claude Code

version

0.2.0

author

Artur Briugeman <artur@nostr.band>

license

MIT

tags

legal, law-firms, service-providers, lead-generation, servicegraph

metadata.api_base

https://api.servicegraph.co

metadata.dataset_id

pro_services

metadata.industry

legal

filter   := orExpr
orExpr   := andExpr ("OR" andExpr)*
andExpr  := notExpr (("AND")? notExpr)*    # whitespace = implicit AND
notExpr  := ("NOT" | "-") notExpr | atom
atom     := "(" filter ")" | predicate
predicate:= IDENT op valueOrList | bareword
op       := ":" | "=" | ">=" | "<=" | ">" | "<"
valueOrList := value ("," value)*
value    := IDENT | NUMBER | tagAtEvidence
tagAtEvidence := IDENT "@" ("low"|"medium"|"high")
bareword := IDENT | NUMBER          # → keyword:<bareword>

industry:legal state:CA patent
industry:legal state:NY,DE m&a
industry:legal employment
industry:legal securities ipo
industry:legal "data privacy" gdpr
industry:legal "commercial litigation" state:TX
industry:legal -company_size_signal:solo rating>=4 review_count_total>=20
industry:legal corporate startup

GET /v1/datasets/pro_services/search?filter=industry:legal+state:CA+patent+-company_size_signal:large_50plus&limit=10
# Present, get pick of 3. "Unlocking 3 = 30 credits, 30-day TTL."
POST /v1/datasets/pro_services/unlocks
  { "apexes": ["firm-a.com", "firm-b.com", "firm-c.com"] }

GET /v1/datasets/pro_services/search?filter=industry:legal+state:NY+m&a&limit=10

GET /v1/datasets/pro_services/search?filter=industry:legal+securities+ipo&limit=10

GET /v1/datasets/pro_services/search?filter=industry:legal+(gdpr OR ccpa OR privacy)+compliance&limit=10

POST /v1/datasets/pro_services/translate-intent
  { "intent": "outside counsel for GDPR/CCPA compliance and SOC2 oversight" }

GET /v1/datasets/pro_services/search?filter=industry:legal+employment+tech+company_size_signal:medium_10_50,small_2_10&limit=10

GET /v1/datasets/pro_services/search?filter=industry:legal+commercial+litigation+state:TX+rating>=4&limit=10

GET /v1/datasets/pro_services/fields?include_values=1
GET /v1/datasets/pro_services/check?filter=industry:legal+state:CA+patent+rating>=4+-company_size_signal:large_50plus
GET /v1/datasets/pro_services/search?filter=...&limit=10
# Present briefs. "Unlocking 3 = 30 credits, 30-day TTL."
POST /v1/datasets/pro_services/unlocks
  { "apexes": ["firm-a.com", "firm-b.com", "firm-c.com"] }
GET /v1/me/credits

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/mcp/servicegraph/skills/find-law-firm of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit cfae287