OddessyDOCUMENTATION
AGENTIC ACCESS Beta

Read-only MCP tool catalogue

Fifteen typed tools for fleet, releases, model provenance, monitoring, integrations, outbound delivery, status and documentation.

Last updated 27 July 2026 ยท Documentation version 2026.07

Fleet

READfleet.list_devicesdevices.read

Filters tenant devices by status and location. Returns health, hardware, platform, runtime and last heartbeat without device credentials.

READfleet.get_devicedevices.read

Returns one device from the authenticated tenant partition. Cross-tenant device IDs resolve as not found.

READfleet.get_summarydevices.read + status.read

Summarizes device, OTA, active-alert and outbound-delivery health without claiming a physical action.

Releases and models

READrelease.list_approvedreleases.read

Lists checksum-published metadata. It never issues private download URLs.

READmodel.list_provenancemodels.read

Returns model name, version, source, runtime, SHA-256 and device-reported verification state.

IoT integrations

READintegration.listintegrations.read
READiot.list_devicesiot.read
READiot.list_recent_eventsiot.read

These tools exclude integration credentials and enforce tenant ownership before reading recent events.

Monitoring and determinations

READmonitor.liststatus.read
READalert.list_recentstatus.read
READdetermination.list_recentmodels.read

These tools separate current alert state from retained transitions and expose bounded VLM/VLA evidence.

Outbound delivery

READwebhook.list_outboundintegrations.read
READwebhook.list_deliveriesintegrations.read

Signing secrets, event payloads and URL query values are never returned.

Status and documentation

READstatus.get_hosted_servicesstatus.read
READdocs.get_pageoddessy.read

Tool safety annotations

Every v0.2 tool advertises readOnlyHint: true, destructiveHint: false and idempotentHint: true. Tool calls are audit logged with tenant, actor, scopes, request hash, result code, region, trace and latency.

Explicitly unavailable

raw PLC writes
arbitrary shell execution
arbitrary customer-network proxying
secret retrieval
safety-interlock override
device enrolment
release deployment or rollback
approval decisions