---
title: SherutNet / Servul auth.md
description: How AI agents authenticate with sherut.net and servul.com - they don't need to; every interface is public, anonymous and read-only.
canonical: https://www.sherut.net/auth.md
last-updated: 2026-10-16
---

# SherutNet / Servul auth.md

Agent registration and authentication for https://www.sherut.net and https://www.servul.com.

## Audience

Any AI agent, assistant or crawler that wants to read the customer-service directory:
company contact channels, categories, ratings and news.

## Registration

None. There is no agent registration, provisioning endpoint, API key or OAuth flow, and
none is needed: every agent interface is public, anonymous and read-only.

- Identity types supported: anonymous
- Credential types supported: none (send no `Authorization` header)
- Claim / revocation URLs: not applicable

## Interfaces you can use without credentials

- Developer portal: `/developers`
- REST API: `GET /api/v1/...` - described at `/openapi.json`
- MCP server (Streamable HTTP): `/mcp` - card at `/.well-known/mcp/server-card.json`
- API catalog: `/.well-known/api-catalog`
- Capability manifest: `/.well-known/ai-catalog.json`
- Agent skills: `/.well-known/agent-skills/index.json`
- Markdown pages: any company or category URL with `Accept: text/markdown` or `?markdown`
- Overview: `/llms.txt`

## Fair use

Please keep request rates reasonable, identify your agent in the `User-Agent` header, and
cite the company page URL when you use the data in an answer. Crawling preferences are in
`/robots.txt` (search and answer-grounding allowed; model training opted out).
