Find AI Directories

What it does

When your agent uses it

• The user wants to find
• Shortlist directories and listing sites where they can submit an AI product — an AI tool
• Agent skill / plugin — to get backlinks
• Referral traffic

Example prompts

• “where can I list my AI tool”
• “directories to submit my AI agent”
• “agent-skills directories”
• “/find-ai-directories”

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/product_directory/fields?include_values=1 — confirm the
3. 3Build the filter (Filter DSL below) and validate it with
4. 4GET /v1/datasets/product_directory/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/product_directory/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 AI Directories loads about 3.6k tokens when it runs. Until then it costs about 259 tokens; SKILL.md has 1,345 words of instructions outside code blocks.

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

~259

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:64

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

• NoteMentions a .env fileSKILL.md:117

  read `.env*` into context; route authed calls through a shell wrapper.

• NoteMentions a .env fileSKILL.md:119

  e call** through a wrapper that sources `.env.local`:

• NoteMentions a .env fileSKILL.md:122

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

• NoteMentions a .env fileSKILL.md:130

  and add `SERVICEGRAPH_API_KEY=vk_…` to `.env.local` (or export it). Tell me

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,345 words, ~3,643 tokens.

name

find-ai-directories

description

Use whenever the user wants to find, rank, or shortlist directories and listing sites where they can submit an AI product — an AI tool, AI app, AI agent, or agent skill / plugin — to get backlinks, referral traffic, and discovery. Triggers on "where can I list my AI tool", "directories to submit my AI agent", "agent-skills directories", "best AI tool directories for backlinks", "where do I get my GPT/Claude app discovered", or "pull submission details for these AI-directory domains", even when described indirectly. Drives the ServiceGraph API (api.servicegraph.co) — a catalog of 1,000+ product directories enriched with Domain Rating, backlinks, and organic traffic. Defer to find-mcp-directories for MCP-server listings specifically, and to find-product-directories for general SaaS/software/app launches with no AI angle. Skip finding an AI consultancy/agency to hire (use find-ai-consultancy), comparing AI products ("ChatGPT vs Claude"), building an AI tool (do-the-work), and AI link-building *services*.

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.1.0

author

Artur Briugeman <artur@nostr.band>

license

MIT

tags

ai-tools, directories, backlinks, product-launch, servicegraph

metadata.api_base

https://api.servicegraph.co

metadata.dataset_id

product_directory

metadata.niche

ai_tools_agents_skills

"ai tools" dr>=50
("ai agents" OR "ai agent") dr>=40
skills agent          # → keyword:skills AND keyword:agent  (agent-skill registries)
industry:software_saas ai

GET /v1/datasets/product_directory/search?filter="ai tools"+dr>=50&limit=20
# → aichief.com, aiagentstore.ai, … sorted by dr desc. Present top N (free).

GET /v1/datasets/product_directory/search?filter=("ai agents" OR "ai agent")&limit=20
# → aiagentsdirectory.com, agenthunter.io, aiagentstore.ai, smithery.ai, …

GET /v1/datasets/product_directory/search?filter=skills+agent&limit=15
# → skills.sh, smithery.ai, aiagentsdirectory.com, agentskills.so, … sorted by dr desc

GET /v1/datasets/product_directory/search?filter="ai tools"+organic_traffic>=20000&limit=15
# organic_traffic is gated but filterable — unlock picks to see the numbers.

POST /v1/datasets/product_directory/translate-intent
  { "intent": "directories to list an AI agent for backlinks and discovery" }
# → {filter, normalized, count}. Sanity-check count, then search.

# Present briefs ranked by dr (free). "Unlocking 6 = 60 credits, 30-day TTL —
# reveals each one's submission note (how + backlink yes/no) and traffic."
POST /v1/datasets/product_directory/unlocks
  { "apexes": ["clawhub.ai", "aiagentsdirectory.com", "aichief.com", "..."] }

# 1. Discover (once per session)
GET /v1/datasets/product_directory/fields?include_values=1

# 2. Two scoped searches (free), both pre-sorted by dr desc
GET /v1/datasets/product_directory/search?filter=("ai agents" OR "ai agent")+dr>=40&limit=15
GET /v1/datasets/product_directory/search?filter=skills+agent&limit=15   # agent-skill registries

# 3. Present merged shortlist ranked by dr. User picks 5.
#    "Unlocking 5 = 50 credits, 30-day TTL — reveals submission notes + traffic."

# 4. Atomic unlock (charges 50 credits)
POST /v1/datasets/product_directory/unlocks
  { "apexes": ["smithery.ai", "skills.sh", "aiagentsdirectory.com", "agenthunter.io", "aichief.com"] }

# 5. Surface each editor_note verbatim + traffic so the user can prioritize.

© 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-ai-directories of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit cfae287