GET /api/capabilities?limit=500 does not mean the catalog has 500 tools. It means one response will not return more than 500. The catalog currently holds 1940 unique tools. An unfiltered call with limit=500 returns 500.

If your client stores that first صفحة and stops, you are missing most of the registry. 560 of the 1940 are مجاني; 1380 are مدفوع. Those totals are not visible from a single uncapped-looking request that is, in fact, capped.

Confirm the cap on a raw call

GET https://swarme.io/api/capabilities?limit=500

Count the returned capabilities. If you send limit=1000, do not assume 1000 items. The observed maximum on this endpoint is 500.

Docs at https://swarme.io/developers describe بحث by natural-language query and category. Category is the practical way past the cap. Query (q) narrows. It does not صفحة the rest of the 1940.

HTML أداة صفحات in a catalog smoke check still returned HTTP 200 around entries 1024 and 1025. The public directory is larger than one API صفحة. Use the API with filters, not a single dump.

Use category slugs, not homepage labels

Homepage labels are not always the query value. Three mismatches:

Homepage ملصقWrong guessesAPI slugCountالويب وSEOweb, seo, web_seo, web-and-seoweb-seo123أمان & شبكةأمان, شبكة, أمان_شبكةsecurity-network134أدوات الذكاء الاصطناعيai, ai-tool, aitoolsai-tools112

GET /api/capabilities?category=web is the wrong contract. category=web-seo returns the 123 Web & SEO tools.

Full category set and observed counts:

  • أداة مساعدة 254
  • أعمال 226
  • مطوّر 189
  • security-network 134
  • مستند 129
  • web-seo 123
  • صورة 116
  • ai-tools 112
  • PDF 109
  • ai-write 97
  • نص 97
  • فيديو 97
  • ملف 92
  • صوت 89
  • QR 76

Those fifteen buckets sum إلى 1940. Every category count is under 500, so one request per slug covers that slice. Union by slug. Deduplicate if a أداة ever appears in more than one response.

A fetch loop that actually terminates

  1. إنشاء a key at https://swarme.io/dashboard?tab=developers. /dashboard/developers returns 404.
  2. Hold the fifteen slugs above. Do not derive them by lowercasing the homepage ملصق.
  3. For each slug, GET /api/capabilities?category={slug}&limit=500.
  4. Record slug, access_level, execution.machine_run_status, and the أداة URL.
  5. If a response is 500 items long, inspect it. For the current catalog, no category reaches that الحجم. If one does later, you need an additional filter or cursor, not a higher limit.
  6. Sleep between calls. Catalog describe under load produced SSL EOF (UNEXPECTED_EOF_WHILE_READING). Back off rather than widening concurrency.

بحث remains useful once you have a query:

GET /api/capabilities?q=uuid&limit=10

That path found uuid-generator. It is not how you inventory 1940 slugs.

Listing is not executing

After you have the union, most rows still will not run from the key. 1491 tools are describe_only and block quote/run. 439 are supported. 10 are requires_worker. Read status on describe before quote.

MCP does not bypass the 500 cap by listing 1940 tools. POST https://swarme.io/mcp initialize (protocolVersion 2025-03-26) identified Swarme Capability MCP Alpha 2026.07.15-wallet-alpha. tools/list returned 22 names, including swarme_capabilities_بحث. بحث through that أداة is still a بحث. It is not a full dump.

A completed run of uuid-generator — found by بحث, not by the first 500 unfiltered rows — returned 4cd3c7b6-0495-447a-8efd-9a1374f7599c at $0.00 included after a 900-second quote lock. Public صفحة: https://swarme.io/أداة/uuid-generator. That is one supported أداة مساعدة, not proof your first API صفحة was complete.

Auth and validation are separate from paging

Unauthenticated quote is HTTP 419. The login toast Your secure نموذج token expired. Please go back and try again. is a form-token expiry. Neither is a capabilities-list error.

Once you start quoting supported tools, empty صفحات of input still 422. Observed run messages include Use labeled address lines in key: value نموذج or provide JSON., Domain must contain valid ASCII hostname labels., backlinks must contain between 1 and 1,000 records., and Enter valid Base64URL input. Fix input after you have the right slug. Do not refetch the first 500 hoping the حقل rule changes.

Wallet $0.00 with metered_observe and a dashboard Lifetime of $0 does not change how many tools بحث returns. It only affects spend on paid runs.

Checklist

  1. Call unfiltered limit=500 once and record that you received 500, not 1940.
  2. Iterate the fifteen category slugs, including web-seo, security-network, and ai-tools.
  3. Union إلى 1940 unique slugs.
  4. Describe before quote. Expect 1491 describe_only.
  5. Keep request rate low enough إلى avoid SSL EOF.
  6. For MCP clients, tools/list (22 tools), then swarme_capabilities_بحث with a category — same cap discipline.

For matching a request إلى a bounded capability once the catalog is loaded, see AI أداة routing. For file-handling tools in that list, see how إلى choose a secure عبر الإنترنت ملف أداة before رفع.