Fast.io

member

Destructive

Workspace/share member management: list, add, remove, update, transfer ownership, join, leave. Call action='describe' for the full action/param reference. Destructive: remove.

Input Schema

TableJSON Schema

Name	Required	Description
`role`	No	Share permission level.
`limit`	No	Maximum number of items to return (1-500, default 100)
`action`	Yes	Operation. Use 'describe' for full action reference.
`offset`	No	Number of items to skip (default 0)
`expires`	No	Membership expiration — `YYYY-MM-DD HH:MM:SS UTC` for BOTH workspace and share. ISO 8601 is NOT accepted (406).
`message`	No	Invitation email message (10-255 chars).
`user_id`	No	User profile ID (share).
`entity_id`	No	Workspace or share ID (19-digit numeric or custom name). Must match entity_type.
`member_id`	No	Member ID (workspace).
`expiration`	No	Alias for expires (share only).
`entity_type`	No	Workspace or share.
`permissions`	No	Workspace permission level.
`display_limit`	No	How many members to return for the list action. Default 10, max 500. The MCP trims post-fetch; backend paging stays MCP-internal so the platform cache stays warm.
`notifications`	No	Notification preference (workspace string).
`invitation_key`	No	Invitation key string.
`notify_options`	No	Notification preference (share).
`email_or_user_id`	No	Email (to invite) or user ID (to add directly).
`invitation_action`	No	Accept or decline.
`force_notification`	No	Force notify existing user (workspace-only).
`invitation_expires`	No	Invitation expiration ISO 8601 (workspace-only).

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedAug 10, 2026

changedInput schema / properties / expires / description

Previous value: -"Expiration: workspace ISO 8601, share YYYY-MM-DD HH:MM:SS."New value: +"Membership expiration — `YYYY-MM-DD HH:MM:SS UTC` for BOTH workspace and share. ISO 8601 is NOT accepted (406)."

Changed1 schema field changedAug 6, 2026

changedInput schema / properties / display_limit / description

Previous value: -"How many members to return for the list action. Default 10, max 500. The MCP trims post-fetch; backend paging stays MCP-internal so the platform cache stays…"New value: +"How many members to return for the list action. Default 10, max 500. The MCP trims post-fetch; backend paging stays MCP-internal so the platform cache stays warm."

Changed5 schema fields changedJun 26, 2026

changedInput schema / properties / action / enum

Previous value: -[
-  "describe",
-  "add",
-  "remove",
-  "details",
-  "update",
-  "transfer-ownership",
-  "leave",
-  "join",
-  "join-invitation"
-]New value: +[
+  "describe",
+  "list",
+  "add",
+  "remove",
+  "details",
+  "update",
+  "transfer-ownership",
+  "leave",
+  "join",
+  "join-invitation"
+]

addedInput schema / properties / display_limit

Added value: +{
+  "description": "How many members to return for the list action. Default 10, max 500. The MCP trims post-fetch; backend paging stays MCP-internal so the platform cache stays…",
+  "maximum": 500,
+  "minimum": 1,
+  "type": "integer"
+}

changedInput schema / properties / entity_id / description

Previous value: -"Opaque ID of a specific object (file, comment, worklog entry, etc.). Pair with entity_type to disambiguate. 19-digit ID or custom name."New value: +"Workspace or share ID (19-digit numeric or custom name). Must match entity_type."

addedInput schema / properties / limit

Added value: +{
+  "description": "Maximum number of items to return (1-500, default 100)",
+  "maximum": 500,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / offset

Added value: +{
+  "description": "Number of items to skip (default 0)",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

Changed19 schema fields changedMay 5, 2026

changedInput schema / properties / action / description

Previous value: -"Operation to perform"New value: +"Operation. Use 'describe' for full action reference."

changedInput schema / properties / action / enum

Previous value: -[
-  "add",
-  "remove",
-  "details",
-  "update",
-  "transfer-ownership",
-  "leave",
-  "join",
-  "join-invitation"
-]New value: +[
+  "describe",
+  "add",
+  "remove",
+  "details",
+  "update",
+  "transfer-ownership",
+  "leave",
+  "join",
+  "join-invitation"
+]

changedInput schema / properties / email_or_user_id / description

Previous value: -"Email address (to invite) or user profile ID (to add directly) (required for: add)"New value: +"Email (to invite) or user ID (to add directly)."

changedInput schema / properties / entity_id / description

Previous value: -"19-digit workspace or share ID, or custom name"New value: +"Opaque ID of a specific object (file, comment, worklog entry, etc.). Pair with entity_type to disambiguate. 19-digit ID or custom name."

changedInput schema / properties / entity_type / description

Previous value: -"Whether managing workspace or share membership"New value: +"Workspace or share."

changedInput schema / properties / expiration / description

Previous value: -"Membership expiration (alias for expires, share only) (used by: update)"New value: +"Alias for expires (share only)."

changedInput schema / properties / expires / description

Previous value: -"Membership expiration date (workspace: ISO 8601, share: YYYY-MM-DD HH:MM:SS) (used by: add, update)"New value: +"Expiration: workspace ISO 8601, share YYYY-MM-DD HH:MM:SS."

changedInput schema / properties / force_notification / description

Previous value: -"Force send notification email to existing user (workspace-only) (used by: add)"New value: +"Force notify existing user (workspace-only)."

changedInput schema / properties / invitation_action / description

Previous value: -"Whether to accept or decline the invitation (required for: join-invitation; optional for: join)"New value: +"Accept or decline."

changedInput schema / properties / invitation_expires / description

Previous value: -"Invitation expiration date (ISO 8601, workspace-only) (used by: add)"New value: +"Invitation expiration ISO 8601 (workspace-only)."

changedInput schema / properties / invitation_key / description

Previous value: -"Unique invitation key string (required for: join-invitation; optional for: join)"New value: +"Invitation key string."

changedInput schema / properties / member_id / description

Previous value: -"Member ID (required for: remove; required for workspace: details, update, transfer-ownership)"New value: +"Member ID (workspace)."

changedInput schema / properties / message / description

Previous value: -"Custom message to include in invitation email (10-255 chars) (used by: add)"New value: +"Invitation email message (10-255 chars)."

changedInput schema / properties / notifications / description

Previous value: -"Notification preference (workspace: string, share: enum format) (used by: add, update, join)"New value: +"Notification preference (workspace string)."

changedInput schema / properties / notify_options / description

Previous value: -"Notification preference for shares (alias for notifications) (used by: update, join)"New value: +"Notification preference (share)."

changedInput schema / properties / permissions / description

Previous value: -"Permission level for workspace members (admin, member, guest) (used by: add, update)"New value: +"Workspace permission level."

changedInput schema / properties / role / description

Previous value: -"Permission level for share members (admin, member, guest, view) (used by: add, update)"New value: +"Share permission level."

changedInput schema / properties / user_id / description

Previous value: -"User profile ID (required for share: details, update, transfer-ownership)"New value: +"User profile ID (share)."

changedInput schema / required

Previous value: -[
-  "action",
-  "entity_type",
-  "entity_id"
-]New value: +[
+  "action"
+]

First observedApr 15, 2026

TDQS

A4.2/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=false and destructiveHint=true. The description goes beyond this by identifying 'remove' as the destructive action and by disclosing the self-describing action='describe' behavior. This adds specific context without contradicting annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three short sentences: purpose with operations, the 'describe' instruction, and a destructive warning. Every sentence earns its place with no redundancy or filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (10 actions, 20 parameters, no output schema), the description provides a concise overview and leverages the built-in 'describe' action for full detail. It doesn't outline return values, but that's acceptable without an output schema. It is sufficient for orientation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, meaning all 20 parameters have descriptions. The description text itself adds no parameter-level detail beyond pointing to action='describe' for more information, so it meets the baseline for fully-covered schemas.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly specifies 'Workspace/share member management' and enumerates the operations: list, add, remove, update, transfer ownership, join, leave. This distinguishes it from sibling tools like share (managing shares) and workspace (workspace settings).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides clear context for when to use the tool (member management for workspace/share) and instructs to call action='describe' for the full action/param reference. It does not explicitly contrast with sibling tools or state exclusions, but the resource scope is unambiguous.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Fast.io tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?