MCP Tools Reference

This is the complete list of tools available through MCP. Available tools depend on your token's permission level.

Tool	Permission	Description
`users_list`	read	List all users in the account
`users_get`	read	Get details about a specific user
`users_search`	read	Search users by name or email
`users_invite`	write	Invite a new user to the account
`users_update_role`	write	Change a user's role (member/admin)
`users_remove`	full	Remove a user from the account

Example: List Users

"List all users in my account"

Returns user details including ID, email, name, role, and join date.

Example: Invite User

"Invite [email protected] as an admin"

Creates and sends an invitation email.

Account Tools

Tool	Permission	Description
`account_get`	read	Get account details and plan info
`account_update`	write	Update account name or billing email

Example: Get Account

"What's my current account plan?"

Returns account name, plan, user count, and settings.

Invitation Tools

Tool	Permission	Description
`invitations_list`	read	List all invitations with status
`invitations_get`	read	Get details about an invitation
`invitations_create`	write	Create a new invitation
`invitations_cancel`	full	Cancel a pending invitation

Example: List Invitations

"Show me all pending invitations"

Returns invitations with status, email, role, and expiration.

Tool Response Format

All tools return structured data that your AI assistant interprets. For example, users_list returns:

{
  "items": [
    {
      "id": "usr_abc123",
      "email": "[email protected]",
      "name": "Jane Smith",
      "role": "admin",
      "joined_at": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 5
  }
}

Pagination

List tools support pagination:

page: Page number (default: 1)
per_page: Results per page (default: 25, max: 100)

"List users, page 2, 50 per page"

Error Handling

If a tool fails, the assistant will explain the error:

Permission denied: Your token lacks the required permission
Not found: The requested resource doesn't exist
Validation error: Invalid parameters provided

Rate Limiting

MCP shares the same rate limit as the REST API: 100 requests per minute per token.

MCP Tools Reference