@devries-cameron20 / composio Mirror · read-only / commits / 82d39da58
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 17:15 UTC

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: