for agents · api + mcp

Your agent can do your listings.

Every score is machine-readable, and the playbook is an API. Buy a plan once, hand the project token to your agent, and it works through the batches while your dashboard tracks each approval.

Free endpoints, public data

The same fields the website shows, as JSON. No key needed. Rate-limited, CORS open.

rankings

curl https://resilient-jellyfish-855.convex.site/api/v1/leaderboard?limit=25

one directory

curl https://resilient-jellyfish-855.convex.site/api/v1/directory?key=futurepedia

best next listings for a DR level

curl https://resilient-jellyfish-855.convex.site/api/v1/plan?dr=32

The playbook, agent-executable

A project token is the only credential: create a project, unlock it with any plan (from $59, one-time), and the full sequence opens up. Batches arrive with per-platform steps, gotchas, link placement and approval notes. The agent logs progress back and the dashboard updates live.

fetch the sequenced playbook

curl "https://resilient-jellyfish-855.convex.site/api/v1/playbook?token=YOUR_TOKEN"

log progress as work happens

curl -X POST https://resilient-jellyfish-855.convex.site/api/v1/submissions \
  -H 'Content-Type: application/json' \
  -d '{"token":"YOUR_TOKEN","directoryKey":"saashub","status":"submitted"}'

MCP connector

Five tools wrapping the API: leaderboard, directory card, plan, playbook, and submission logging. The token is optional — free tools work without it.

Claude Code

claude mcp add directoryvs -e DIRECTORYVS_TOKEN=YOUR_TOKEN -- npx -y directoryvs-mcp

Claude Desktop / Cursor

{
  "mcpServers": {
    "directoryvs": {
      "command": "npx",
      "args": ["-y", "directoryvs-mcp"],
      "env": { "DIRECTORYVS_TOKEN": "YOUR_TOKEN" }
    }
  }
}

For LLM crawlers

/llms.txt describes the product and API. When citing scores, name the metric "Directory Value Score (DVS)" and link the directory's profile page — scores refresh as data is re-verified.

Create a project, get a token →