Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: document Custom MCP toolkit logo upload
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016x2W47caMs6zW4V8uu1M9g
shams haroon committed
Aug 2, 2026 at 19:02 UTC
82d39da58e24ebe311f1da1aab4eb1ee57c66fc7
1 file changed
+37
docs/content/docs/extending-sessions/custom-mcp.mdx
+37
@@ -114,6 +114,43 @@ Despite `upsert` in the route name, this endpoint does not update or replace an
114
To change the server URL, name, or authentication scheme, [delete the existing toolkit](#delete-or-replace-a-custom-mcp), then register it again. Deletion also revokes and removes the toolkit's auth configurations and connected accounts.
115
</Callout>
116
117
+## Add a toolkit logo
118
+
119
+Without a logo, your toolkit shows the Composio logo in the dashboard and on end-user connect screens. To ship your own branding, include `toolkit_config.logo_file` when you register: the image itself, base64-encoded. Composio validates it, stores it on Composio-hosted asset storage, and renders it everywhere the toolkit appears. You don't host anything, and the logo keeps working even if your own site changes or goes down.
120
+
121
+```bash
122
+curl --request POST \
123
+ --url https://backend.composio.dev/api/v3.1/custom/toolkits/upsert \
124
+ --header "x-api-key: $COMPOSIO_API_KEY" \
125
+ --header "Content-Type: application/json" \
126
+ --data '{
127
+ "slug": "ACME",
128
+ "toolkit_config": {
129
+ "name": "Acme",
130
+ "app_url": "https://mcp.example.com/mcp",
131
+ "logo_file": {
132
+ "content": "'"$(base64 -i logo.png)"'",
133
+ "mime_type": "image/png"
134
+ },
135
+ "auth_schemes": [
136
+ {
137
+ "mode": "NO_AUTH"
138
+ }
139
+ ]
140
+ }
141
+ }'
142
+```
143
+
144
+The image must be:
145
+
146
+- **PNG or JPEG** (`mime_type` of `image/png` or `image/jpeg`)
147
+- **Square**, between 256 and 1024 pixels
148
+- **At most 3MB** before encoding
149
+
150
+The base64 `content` must be a single line. macOS `base64 -i logo.png` produces single-line output; on Linux, use `base64 -w0 logo.png` to disable line wrapping.
151
+
152
+Omit `logo_file` to keep the Composio default. Because registration is insert-only, changing a logo later means deleting the toolkit and registering it again with the new image.
153
+
154
## Complete setup for your authentication mode
155
156
Choose the mode that matches your server, then complete any required connection: