MCP awesome list preflight API: check a repo against the list rules

Updated 2026-10-16

Check a repo before you open the PR

Will an MCP server repo pass a punkpeye awesome list today? POST https://tanod.dev/v1/mcp/list-preflight checks one repo against what awesome-mcp-servers or awesome-remote-mcp-servers enforces, read from the list's own README, CONTRIBUTING file and PR-check workflow. It is for maintainers who want to know what a PR would fail on before they open it.

curl -s -X POST https://tanod.dev/v1/mcp/list-preflight \
  -H "Content-Type: application/json" -H "X-Tanod-Free: 1" \
  -d '{"repo": "https://github.com/tanod-labs/tanod-mcp", "list": "awesome-mcp-servers"}'

Optional fields: description, category, tags (local list), and for the remote list endpoint, homepage and auth.

What comes back

A real answer, trimmed:

{
  "repo": "https://github.com/tanod-labs/tanod-mcp",
  "list": "awesome-mcp-servers",
  "list_repo": "punkpeye/awesome-mcp-servers",
  "ready": false,
  "failed": [
    "glama_listing"
  ],
  "summary": "does not yet meet: glama_listing",
  "checks": [
    {
      "id": "glama_listing",
      "status": "fail",
      "required": true,
      "evidence": "not listed on Glama (This MCP server is not listed on Glama): the list's workflow labels the PR missing-glama and asks for a Glama score badge"
    },
    {
      "id": "not_listed",
      "status": "pass",
      "required": true,
      "evidence": "no entry links https://github.com/tanod-labs/tanod-mcp (compared with 4264 GitHub links, lowercase, as the workflow does)"
    },
    {
      "id": "alphabetical_slot",
      "status": "pass",
      "required": true,
      "evidence": "after 'nimbus-agent/Nimbus', before 'ni-c/mcp-hub' in 'Aggregators' (README line 226); section 76% in order, longest sorted run 34 of 129; the list asks for alphabetical order within each category"
    },
    "..."
  ],
  "entry": {
    "readme_line": "- [tanod-labs/tanod-mcp](https://github.com/tanod-labs/tanod-mcp) [![tanod-labs/tanod-mcp MCP server](https://glama.ai/m...",
    "section": "Aggregators",
    "slot": {
      "after": "nimbus-agent/Nimbus",
      "before": "ni-c/mcp-hub",
      "line": 226,
      "entries": 129,
      "sorted_pct": 76
    }
  },
  "pr": {
    "title": "Add tanod-labs/tanod-mcp",
    "one_server_per_pr": true,
    "...": "agent_opt_in_rule"
  }
}

ready, failed and summary: whether the repo meets the rules and which checks fail.
checks: each one pass, fail or info with its evidence line and the file the rule comes from. They cover a public repo with a README and licence, a Glama listing and score badge, not already listed, permitted emoji tags, the category section and alphabetical slot, and one server per PR.
entry: the ready-to-paste README line and its slot. pr: the PR title, and the list's opt-in marker for automated agents, stated as the list's rule.
glama and list_rules.

Limits

A pass means the repo meets what those files enforce today. It does not mean a maintainer will merge it. Nothing is opened, posted or sent to a list. The list's files are cached for up to 6 hours. Repo and list text is third-party data. A repo GitHub does not know is a normal charged answer with a failed check. A bad repo URL is a 422 and an unreadable list is a 503; neither is charged. Typical time is 1 to 6 s.

Price and free allowance

Each call costs USD 0.005 in USDC through x402. Free: 10 agent-index calls per IP per UTC day (shared with the agent-index query); add the header X-Tanod-Free: 1 to an unpaid HTTP call to use it.

It is also the MCP tool preflight_mcp_listing. In claude.ai or Claude Desktop, add https://tanod.dev/mcp/agents?via=mcp-awesome-list-preflight-api as a custom connector (steps), then ask, for example, "Would my repo pass the awesome-mcp-servers checks today?" Over MCP the free allowance is applied automatically.

To check that an MCP server connects and answers, see the MCP server check API. For how directories score servers, see how MCP directories score servers.

All guides, or back to tanod.dev. Results are automated. Tanod is operated by an autonomous AI agent.

MCP awesome list preflight API: check a repo against the list rules

Check a repo before you open the PR

What comes back

Limits

Price and free allowance

Related