140
# Explicit disable configuration
141
'slack': {'disable': ['SLACK_DELETE_MESSAGE']},
142
143
- # Filter by MCP tags (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
144
- 'linear': {'tags': ['readOnlyHint', 'idempotentHint']}
143
+ # Filter by behavior tags (readOnlyHint, destructiveHint, createHint, updateHint)
144
+ 'linear': {'tags': ['readOnlyHint', 'createHint']}
145
}
146
)
147
```
154
session = composio.tool_router.create(
155
user_id='user_123',
156
toolkits=['gmail', 'github', 'slack'],
157
- tags=['readOnlyHint', 'idempotentHint'] # Only show read-only and idempotent tools
157
+ tags=['readOnlyHint', 'createHint'] # Only show tools that read or create
158
)
159
```
160
161
-Available tag values:
161
+Available tag values (every tool carries at least one of the first four):
162
- `'readOnlyHint'`: Tools that only read data
163
-- `'destructiveHint'`: Tools that modify or delete data
164
-- `'idempotentHint'`: Tools that can be safely retried
165
-- `'openWorldHint'`: Tools that operate in an open world context
163
+- `'createHint'`: Tools that create a new resource
164
+- `'updateHint'`: Tools that modify an existing resource in place
165
+- `'destructiveHint'`: Tools that irreversibly remove, cancel or revoke data
166
+- `'idempotentHint'`: Tools that can be safely retried (MCP hint, partial coverage)
167
+- `'openWorldHint'`: Tools that operate in an open world context (MCP hint, partial coverage)
168
169
### `auth_configs`
170
744
})
745
746
ToolRouterToolsTagsConfig = TypedDict('ToolRouterToolsTagsConfig', {
745
- 'tags': List[Literal['readOnlyHint', 'destructiveHint', 'idempotentHint', 'openWorldHint']]
747
+ 'tags': List[Literal['readOnlyHint', 'destructiveHint', 'createHint', 'updateHint', 'idempotentHint', 'openWorldHint']]
748
})
749
750
ToolRouterToolsConfig = Union[
757
tools: Dict[str, ToolRouterToolsConfig] # Key is toolkit slug, value is ToolRouterToolsConfig
758
759
# Tags configuration (global)
758
-tags: List[Literal['readOnlyHint', 'destructiveHint', 'idempotentHint', 'openWorldHint']]
760
+tags: List[Literal['readOnlyHint', 'destructiveHint', 'createHint', 'updateHint', 'idempotentHint', 'openWorldHint']]
761
762
# Manage connections configuration
763
ToolRouterManageConnectionsConfig = TypedDict('ToolRouterManageConnectionsConfig', {