For agents
Use this directory from an agent
Scriptiii Webnest is a reviewed directory of websites filed by what they do. An agent can search approved listings, read one listing with its pricing, tags and upvotes, list categories and comparisons. The read-only tools need no key: post JSON-RPC to /api/mcp.
1. Connect
Remote MCP over HTTP. The server speaks 2025-06-18 and answers initialize, tools/list and tools/call. A request without an id is a notification and gets 202.
curl -s https://webnest.scriptiii.com/api/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_tools","arguments":{"query":"screenshot"}}}'2. Tools
| Tool | What it returns |
|---|---|
| search_tools | Approved listings matching a name or tagline, with slug, category and pricing. |
| get_tool | One listing: tagline, description, pricing, tags, upvotes, website URL. |
| list_categories | Categories with the number of approved listings in each. |
| list_tags | Tags with the number of approved listings carrying each. |
| list_comparisons | Curated head-to-head comparison pages between two listings. |
| get_site_stats | Public listing, vote and badge-click totals. |
| get_seo_status | Canonical discovery URLs and indexable counts. |
| get_legal_page | The currently published revision of a legal page. |
Operator tools — approving a submission, publishing a legal page, invalidating a cache — exist on the same endpoint behind an admin-issued bearer key. They are not advertised to anonymous callers and cannot be reached without one.
3. Discovery files
| Path | What it is |
|---|---|
| /api/mcp | MCP endpoint. JSON-RPC 2.0 over POST. Read-only tools answer without a key; suggest_website queues a website for review. |
| /.well-known/mcp.json | Server card: transport, tool list, auth model, rate limit. |
| /llms.txt | Short directory summary for answer engines. |
| /llms-full.txt | Every approved listing with pricing, tags and description. |
| /sitemap.xml | Every indexable URL. |
| /feed.xml | Newly approved listings, RSS 2.0. |
| /AGENTS.md | This guide as one file, for an agent that wants the rules before the endpoints. |
4. What the data means
- Upvotes are single community votes. They are never star ratings and are never sold.
- Nothing is for sale. The order is community upvotes, then the newest listing.
- Every listing is reviewed by a person before it appears.
- Read-only tools are limited to 120 requests per minute per IP. Every other write needs an admin-issued key.
- suggest_website is the one public write: three suggestions per client per hour, and a suggestion is queued for a person to review — it is never published by the call.
Questions an agent asks
- Does using Scriptiii Webnest from an agent need an API key?
- No. The read-only MCP tools answer anonymously over POST to /api/mcp. Only operator tools (approve, publish, cache, refund) need an admin-issued bearer key, and those are not advertised publicly.
- What is the rate limit for the public MCP endpoint?
- 120 requests per minute per IP for reads. The one public write, suggest_website, is limited to three suggestions per client per hour.
- What does a listing URL look like?
- One listing lives at /w/<host>, its domain. /tool/<slug> is a 308 to that URL. The same listing is available as markdown at /w/<host>.md.
- Are upvotes the same as reviews?
- No. An upvote is a single community vote, one per signed-in account. It is never a star rating, and nothing on this directory is for sale.
- How does a listing get published?
- A person reviews every submission before it appears, and the review date is printed on the listing page. There is no paid queue.
List a website
A person reviews every submission, and listing is free. Nothing on this directory is for sale.