BotPages Add a site

API, MCP and curl

Everything the website does is an endpoint. Reading is open, submitting is open, and there is no API key anywhere on the site. If you are an agent, start with agents.md.

Submit a listing

POST https://botpages.net/api/submit
Content-Type: application/json

{"url": "https://yoursite.com", "email": "you@example.com", "category": "developer-tools"}

Returns 201 with the listing id, its page URL, a manage URL and the badge HTML. category is optional and guessed from the page when omitted. A repeat submission for the same root domain returns 409 with the existing listing.

Verify a badge

POST https://botpages.net/api/verify-badge
{"url": "https://yoursite.com"}

→ {"ok": true, "has_badge": true, "dofollow": true, "listing_id": 42}

Read

EndpointReturns
GET /api/listingsAll active listings. ?category= filters, ?limit= caps at 100.
GET /api/listing/{id}One listing.
GET /api/categoriesCategory slugs, names and counts.
GET /api/statsTotals: listed, verified, added today and this week.
GET /api/search?q=Title, description and host search.

MCP

The endpoint speaks MCP over Streamable HTTP at https://botpages.net/mcp. JSON-RPC in, JSON out. The tool catalog is also published as a static document at agents.json, and the discovery file is at /.well-known/mcp.json.

POST https://botpages.net/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/list"}
ToolDoes
submit_listingSame as POST /api/submit. Arguments: url, email, category.
verify_badgeRe-fetches a listed URL and updates its dofollow state.
list_listingsPaged listing feed, optional category.
get_listingOne listing by id.
list_categoriesSlugs and counts.
get_statsDirectory totals.

Edit and remove

There is no account system, so ownership is a token. The submission response carries a manage URL containing it. That URL can change the listed URL, re-read the metadata, or delete the listing. A URL change resets the badge until it is re-verified on the new domain.

Rules that apply to everyone

  • One active listing per root domain. www and http collapse into the same entry.
  • The page must answer 200 to BotPagesBot/1.0 and carry a title.
  • Parking pages, login walls and error pages are refused at submit time.
  • Submissions are rate limited per IP. Abusing the endpoint gets the IP blocked, not the listing removed.
  • No CAPTCHA, no key, no approval queue — and no paid tier that skips any of this, because there is no paid tier.

Machine-readable files

/llms.txtWhat the site is, in the format LLMs expect.
/agents.mdThe action list for agents.
/agents.jsonThe same actions as a tool catalog.
/openapi.jsonOpenAPI 3.1 spec for the REST surface.
/sitemap.xmlEvery page, including all 13 listings.
/feed.xmlAtom feed of the newest listings.