# Pocket Science developer and agent documentation

Pocket Science publishes stable, same-origin, read-only interfaces for service discovery and public evidence. The canonical information API and MCP endpoint require no authentication and perform no external actions.

## Endpoints

- `GET https://pocket.science/api/pocket-science.json` — canonical typed public profile.
- `POST https://pocket.science/mcp/` — stateless MCP initialization, capability listing and read-only tools.
- `GET https://pocket.science/openapi.json` — OpenAPI 3.1 contract.
- `GET https://pocket.science/.well-known/ai-catalog.json` — bounded AI Catalog.
- `POST https://pocket.science/api/contact.php` — same-origin, rate-limited, reCAPTCHA-protected human form; agents must not submit it without explicit user approval.

No fixed public quota is published for the read-only information and MCP endpoints. Cache stable resources, avoid bursts and respect `Retry-After` when returned.

## MCP discovery

Supported protocol versions: `2024-11-05`, `2025-03-26`, `2025-06-18`. The endpoint is stateless and does not require a session ID. Calling `initialize` or `tools/list` does not invoke a tool.

## Errors

API failures use RFC 9457 `application/problem+json` with `type`, `title`, `status`, `detail`, `instance` and stable `code`. MCP failures use standard JSON-RPC error codes.

## iSPEX documentation

- [Quick-start guide](https://pocket.science/ispex/archive/osf/wikis/quick-start-guide.md)
- [Guide to the iSPEX2 app](https://pocket.science/ispex/archive/osf/wikis/guide-to-the-ispex2-app.md)
- [Measurement protocols](https://pocket.science/ispex/archive/osf/wikis/measurement-protocols.md)
- [Data processing](https://pocket.science/ispex/archive/osf/wikis/data-processing.md)
- [Reference data](https://pocket.science/ispex/archive/osf/wikis/reference-data.md)
- [Preserved file archive](https://pocket.science/ispex/archive/files/)

Source documents retain PML attribution and CC BY-NC-ND 4.0 terms.

## Black Hole Finder resources

- [Product and service overview](https://pocket.science/products/blackholefinder/)
- [Technical capability case study](https://pocket.science/case-studies/black-hole-finder/)
- [Example public follow-up report](https://pocket.science/products/blackholefinder/followups/transient_332449300_report.html)
- [Read-only aggregate platform statistics](https://pocket.science/api/platform-stats.php)

These pages document capability and evidence; they are not a public classification write API.