MCP serverTools reference

Tools reference

Each tool maps to one shared core operation and is registered only when the configured RMS_MCP_MODE is at or above its tier. Domain failures surface as structured tool errors (auth, not_found, validation, upstream) rather than stack traces.

readonly tier — reads & analytics

Available in every mode.

ToolDescription
org_list, org_getList / get organizations
org_member_listList organization members
user_list, user_getList / get users
pool_list, pool_getList / get pools
pool_rule_list, pool_rule_getList / get pool booking rules
resource_list, resource_getList / get resources
resource_capability_list, resource_capability_getList / get resource capabilities
booking_list, booking_getList / get bookings (queue entries)
booking_validateValidate a booking query without submitting it
booking_notification_list, booking_notification_getList / get booking notifications
analytics_statesState/utilization analytics (global, per-pool, per-resource)
analytics_compareCompare resources by time spent in a state

standard tier — bookings (default)

Adds booking create/cancel to the read surface.

ToolDescription
booking_createCreate a booking by querying a pool for a matching resource
booking_cancelCancel a booking (destructive-hint)

admin tier — mutations

Adds every mutating and destructive operation. Pair with a least-privilege token.

ToolDescription
org_createCreate an organization
org_deleteDelete an organization (destructive-hint)
org_member_addAdd an organization member
org_member_removeRemove an organization member (destructive-hint)
user_createCreate a user
user_deleteDelete a user (destructive-hint)
pool_createCreate a pool
pool_deleteDelete a pool (destructive-hint)
pool_rule_createCreate a pool booking rule
pool_rule_deleteDelete a pool booking rule (destructive-hint)
resource_createCreate a resource
resource_deleteDelete a resource (destructive-hint)
resource_capability_createCreate a resource capability
resource_capability_deleteDelete a resource capability (destructive-hint)
booking_notification_createCreate a booking notification
booking_notification_deleteDelete a booking notification (destructive-hint)
lcm_begin, lcm_endBegin / end a lifecycle transition for an event
lcm_mark_readyMark a resource ready for its event

Tools that accept free-form model fields (*_create for users, resources, capabilities, rules, notifications) take a fields object so agents can supply structured payloads; pool_create and booking_create expose first-class typed parameters for the common case.