# info.summary
Unauthenticated, read-only public information about Wagevo.

# info.description
Unauthenticated, read-only access to public Wagevo information for developers and AI agents. Private payments and partner APIs are not included.

## Versioning

This API uses URL path versioning. The current version is v1, served at `https://wagevo.com/api/v1/...` (see `servers`). The unversioned paths `/api/health` and `/api/mcp` are deprecated aliases kept for backward compatibility. Breaking changes will be released under a new version while the previous version remains available for at least 6 months. Deprecations are signaled with the standard `Deprecation` and `Sunset` HTTP response headers.

## Errors

Error responses use RFC 9457 `application/problem+json` with a machine-readable `type`, a human-readable `title` and `detail`, and the HTTP `status`. See the `Error` schema in `components/schemas`.

## Rate limits

Responses include `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` headers (RFC 9331 draft field names). When a request is rejected with HTTP 429, a `Retry-After` header indicates how long to wait before retrying.

# servers[].description
Legacy unversioned base path (deprecated alias for /api/v1)

# paths./api/health.get.summary
Check the public agent information service

# paths./api/health.get.description
Returns service availability. Useful as an unauthenticated liveness probe.

# paths./api/mcp.post.summary
Call the Wagevo Agent Information MCP server

# paths./api/mcp.post.description
JSON-RPC endpoint implementing the Model Context Protocol over Streamable HTTP. Supports `initialize`, `tools/list`, and `tools/call` for the `get_wagevo_information` tool. Batch requests are accepted as a JSON array.

# paths./api/mcp.post.requestBody.content.application/json.schema.description
A single MCP JSON-RPC 2.0 request or a batch array.

# paths./api/mcp.post.responses.200.description
MCP JSON-RPC response (or batch of responses)

# paths./api/mcp.post.responses.202.description
Accepted: the batch contained only notifications, so no response body is returned

# paths./api/v1/health.get.summary
Check the public agent information service

# paths./api/v1/health.get.description
Returns service availability. Useful as an unauthenticated liveness probe.

# paths./api/v1/mcp.post.summary
Call the Wagevo Agent Information MCP server

# paths./api/v1/mcp.post.description
JSON-RPC endpoint implementing the Model Context Protocol over Streamable HTTP. Supports `initialize`, `tools/list`, and `tools/call` for the `get_wagevo_information` tool. Batch requests are accepted as a JSON array.

# paths./api/v1/mcp.post.requestBody.content.application/json.schema.description
A single MCP JSON-RPC 2.0 request or a batch array.

# paths./api/v1/mcp.post.responses.200.description
MCP JSON-RPC response (or batch of responses)

# paths./api/v1/mcp.post.responses.202.description
Accepted: the batch contained only notifications, so no response body is returned

# components.schemas.McpResponse.description
An MCP JSON-RPC 2.0 success or error response

# components.schemas.McpResponse.properties.error.description
JSON-RPC error object, present on failures

# components.schemas.Error.description
RFC 9457 problem details returned on any 4xx or 5xx API error

# components.schemas.Error.properties.type.description
Machine-readable error type URI identifying the failure class

# components.schemas.Error.properties.title.description
Short, human-readable summary of the error

# components.schemas.Error.properties.detail.description
Human-readable explanation specific to this occurrence

# components.schemas.Error.properties.instance.description
URI reference identifying this occurrence of the problem

# components.headers.RateLimitLimit.description
Maximum requests allowed in the current window

# components.headers.RateLimitRemaining.description
Requests remaining in the current window; clients should self-throttle when this approaches zero

# components.headers.RateLimitReset.description
Seconds until the rate-limit window resets

# components.headers.RetryAfter.description
Seconds to wait before retrying after an HTTP 429

# components.responses.BadRequest.description
The request body could not be parsed or was invalid

# components.responses.BadRequest.content.application/problem+json.example.detail
The request body must be a JSON-RPC 2.0 object or array.

# components.responses.MethodNotAllowed.description
HTTP method not allowed for this resource; see the Allow header

# components.responses.TooManyRequests.description
Rate limit exceeded; wait for the duration given by the Retry-After header before retrying

# components.responses.TooManyRequests.content.application/problem+json.example.detail
Rate limit exceeded. Retry after the interval in Retry-After.