# Synorb MCP

Last updated: 2026-09-15

Use MCP for an interactive agent loop. Initialize one warm Streamable HTTP
session per user or workspace and reuse it for discovery and content pulls.
The recommended server URL is `https://mcp.synorb.com/mcp`; send the Synorb
Key as a Bearer token from a secure host-side secret store when calling
account, quota, persistence, or content tools. Streamable HTTP discovery and
catalog/reference tools classified as keyless can be inspected without a
token; account and content access remain authenticated.

Start with profile/status when quota matters, resolve a scope with catalog and
stream search, then pull manifests with citations. Keep production app calls
server-side and render each returned source URL.

## Documentation MCP

Agents that need Synorb setup instructions can use the separate public,
read-only documentation server:

- Server: `https://mcp.synorb.com/docs-mcp`
- Server card: `https://mcp.synorb.com/.well-known/mcp/docs-server-card.json`
- Authentication: none; this surface exposes documentation only and has no
  account, billing, or content access.
- Tools: `docs-list`, `docs-search`, and `docs-fetch`.

Use the documentation server for public instructions, then use Core MCP for
the actual interactive data workflow. It is stateless JSON-RPC over HTTP and
does not replace the authenticated Core MCP session.

## References

- [Runtime agent guide](https://synorb.com/agent-guide.md)
- [Developer integration map](https://synorb.com/developers/llms.txt)
- [Documentation MCP server card](https://mcp.synorb.com/.well-known/mcp/docs-server-card.json)
- [Extended agent reference](https://synorb.com/llms-full.txt)
- [API versioning and deprecation policy](https://synorb.com/docs/api-versioning)

## Documentation resources and ecosystem manifest

Advanced MCP publishes two zero-write reference resources: `synorb://guide`
for agent and tool-selection guidance, and `synorb://domains` for coverage
reference data. They are available through `resources/list` on the Advanced
server; Core MCP keeps its inventory intentionally small.

For machine-readable transport, CLI, SDK, and agent-instruction links, use
the [agent ecosystem manifest](https://synorb.com/agent-ecosystem.json).