# info.summary
Streamable HTTP access to the noticed MCP server

# info.description
The supported noticed agent API is Model Context Protocol over Streamable HTTP. This contract describes the existing JSON-RPC transport; it does not introduce a REST API. Public discovery methods may be called without credentials. Every tool invocation and every operation that can reach relationship data requires a bearer credential with the network:read scope.

# tags[].description
Model Context Protocol JSON-RPC operations

# paths./api/mcp.post.description
Send an MCP request or notification using Streamable HTTP. The public discovery methods are `initialize`, `notifications/initialized`, `ping`, `tools/list`, `resources/list`, `resources/read`. All other methods require OAuth 2.1 or a personal noticed access key. The equivalent standard-location alias is `POST https://www.noticed.so/.well-known/mcp`. Requests and responses are limited to 1 MB at that alias.

# paths./api/mcp.post.parameters[].description
Negotiated MCP protocol version for requests after initialization.

# paths./api/mcp.post.parameters[].description
Session identifier when a negotiated transport session supplies one.

# paths./api/mcp.post.responses.200.headers.MCP-Session-Id.description
Negotiated MCP session identifier, if used.

# components.securitySchemes.noticedOAuth.description
OAuth 2.1 Authorization Code with PKCE S256 for an existing noticed user.

# components.securitySchemes.noticedOAuth.flows.authorizationCode.scopes.network:read
Use the noticed MCP surface for one authenticated user's tenant; server-side tool annotations and authorization still constrain writes.

# components.securitySchemes.noticedAccessKey.description
A personal noticed access key created and revoked by a signed-in user. Send it only in the Authorization header.

# components.responses.ProtocolError.description
Malformed HTTP request or MCP JSON-RPC protocol error

# components.responses.Unauthorized.description
A protected operation needs a valid bearer credential

# components.responses.Unauthorized.headers.WWW-Authenticate.description
Bearer challenge with the noticed protected-resource metadata URL.

# components.responses.PayloadTooLarge.description
The standard-location alias rejected a body over 1 MB

# components.responses.UnsupportedMediaType.description
The request Content-Type was not application/json

# components.responses.RateLimited.description
The credential or transport exceeded its request limit

# components.responses.BadGateway.description
The standard-location alias could not reach the MCP service

# x-noticed-compatibility-policy
The MCP protocol version is negotiated during initialize. Breaking tool-schema changes require a new major noticed MCP API version; additive tools, resources, fields, and descriptions may ship within version 1.