The MCP tool directory.

Modifies an existing authentication configuration with new credentials or other settings. Only specified fields will be updated.

Creates a new auth config for a toolkit, allowing you to use your own OAuth credentials or API keys instead of Composio-managed authentication. This is required when you want to use custom OAuth apps (bring your own client ID/secret) or configure specific authentication parameters for a toolkit.

Soft-deletes an authentication configuration by marking it as deleted in the database. This operation cannot be undone.

Retrieves detailed information about a specific authentication configuration using its unique identifier.

Retrieves all auth configs for your project. Auth configs define how users authenticate with external services (OAuth, API keys, etc.). Use filters to find configs for specific toolkits or to distinguish between Composio-managed and custom configurations.

Updates the status of an authentication configuration to either enabled or disabled. Disabled configurations cannot be used for new connections.

Start here for website login, sign-up, and verification testing. This is the shared auth entrypoint for MCP and CLI workflows. It reuses your saved inbox/password, checks remembered auth state for the site's normalized origin, and returns reusable auth strategy plus site-specific signals such as recommended auth path, account-exists confidence, likely auth method, expected follow-up, and known-site history. Call it again with action='record' after auth attempts to save what worked.

Check if an organization membership has a specific permission on a resource. Supports identification by resource_id OR by resource_external_id + resource_type_slug.

Returns all child resources of a parent resource where the organization membership has a specific permission. This is useful for resource discovery—answering "What projects can this user access in this workspace?" You must provide either `parent_resource_id` or both `parent_resource_external_id` and `parent_resource_type_slug` to identify the parent resource.

Remove a role assignment by role slug and resource.

Assign a role to an organization membership on a specific resource.

Remove a role assignment using its ID.

List all role assignments for an organization membership. This returns all roles that have been assigned to the user on resources, including organization-level and sub-resource roles.

Delete an authorization resource by organization, resource type, and external ID. This also deletes all descendant resources.

Retrieve the details of an authorization resource by its external ID, organization, and resource type. This is useful when you only have the external ID from your system and need to fetch the full resource details.

Returns all organization memberships that have a specific permission on a resource, using the resource's external ID. This is useful for answering "Who can access this resource?" when you only have the external ID.

Update an existing authorization resource using its external ID.

Create a new custom organization role. When slug is omitted, it is auto-generated from the role name.

Delete an existing custom organization role.

Retrieve a role that applies to an organization by its slug. This can return either an environment role or an organization-specific role.

Get a list of all roles that apply to an organization. This includes both environment roles and organization-specific roles, returned in priority order.

Add a single permission to an organization role. If the permission is already assigned to the role, this operation has no effect.

Remove a single permission from an organization role by its slug.

Replace all permissions on a role with the provided list.

Update an existing custom organization role. Only the fields provided in the request body will be updated.

Create a new permission in your WorkOS environment. The permission can then be assigned to environment roles and organization roles.

Delete an existing permission. System permissions cannot be deleted.

Retrieve a permission by its unique slug.

Get a list of all permissions in your WorkOS environment.

Update an existing permission. Only the fields provided in the request body will be updated.