Developer resources
BishopTech API and agent resources.
A small, honest public REST surface for discovery, user-approved consultation requests, the interactive readiness audit, and an MCP interface with public research, visual widgets, and explicit consented actions. Admin, cron, webhook, analytics, and authenticated application routes are intentionally outside this contract.
Public contract
Reachable endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /api/capabilities | Discover the public capability catalog and side effects. |
| GET | /api/aio-api | Read a lightweight service health response. |
| MCP | /api/mcp | Use bounded public research, visual audit and concierge widgets, and explicit consented audit/request actions over Streamable HTTP. |
| POST | /api/contact | Submit a user-approved contact or consultation request. |
| POST | /api/readiness-check/scan | Run a user-requested website readiness scan. |
Calling guidance
Permission stays with the user.
Read capabilities first, then use the smallest endpoint that answers the user's request. No API key is required for the documented public operations.
Important: POST /api/contact creates a lead and may send email. POST /api/readiness-check/scan crawls a submitted website and stores a report. Agents must not trigger either side effect without explicit user intent.
For the complete REST contract, use openapi.json. MCP-compatible clients can use /api/mcp for bounded research, visual audit/concierge widgets, public skills, and explicit consented actions. Use the MCP setup docs for host configuration and llms.txt for retrieval guidance.