Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: document Custom MCP toolkit logo upload
shams haroon82d39da58e24
diff --git a/docs/content/docs/extending-sessions/custom-mcp.mdx b/docs/content/docs/extending-sessions/custom-mcp.mdxindex 00ed7a962..dbc8361ca 100644--- a/docs/content/docs/extending-sessions/custom-mcp.mdx+++ b/docs/content/docs/extending-sessions/custom-mcp.mdx@@ -114,6 +114,43 @@ Despite `upsert` in the route name, this endpoint does not update or replace anTo 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.</Callout>+## Add a toolkit logo++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.++```bash+curl --request POST \+ --url https://backend.composio.dev/api/v3.1/custom/toolkits/upsert \+ --header "x-api-key: $COMPOSIO_API_KEY" \+ --header "Content-Type: application/json" \+ --data '{+ "slug": "ACME",+ "toolkit_config": {+ "name": "Acme",+ "app_url": "https://mcp.example.com/mcp",+ "logo_file": {+ "content": "'"$(base64 -i logo.png)"'",+ "mime_type": "image/png"+ },+ "auth_schemes": [+ {+ "mode": "NO_AUTH"+ }+ ]+ }+ }'+```++The image must be:++- **PNG or JPEG** (`mime_type` of `image/png` or `image/jpeg`)+- **Square**, between 256 and 1024 pixels+- **At most 3MB** before encoding++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.++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.+## Complete setup for your authentication modeChoose the mode that matches your server, then complete any required connection: