{ "name": "ideare", "description": "Where brands are born. ideare makes the brand kit of a small business from one file, brand.json: the logo in every version, colors and fonts, site icons, share cards, every social size, an email signature, a business card and guidelines in plain words.", "homepage": "https://ideare.app", "documentation": "https://ideare.app/en/docs/mcp", "llmsTxt": "https://ideare.app/llms.txt", "llmsFullTxt": "https://ideare.app/llms-full.txt", "openApi": "https://api.ideare.app/openapi.json", "servers": [ { "name": "ideare", "transport": "streamable-http", "url": "https://api.ideare.app/mcp", "authentication": [ { "type": "oauth2", "protectedResourceMetadata": "https://api.ideare.app/.well-known/oauth-protected-resource/mcp", "description": "The person signs in to the studio, picks a workspace and allows the app. The app gets its own key, and its approvals are proposals the owner approves.", "documentation": "https://ideare.app/en/docs/mcp" }, { "type": "api-key", "in": "header", "name": "Authorization", "prefix": "Bearer ", "description": "A key from the studio's Keys page, starting with ideare_. On the free plan it only reads.", "documentation": "https://studio.ideare.app/keys" } ], "tools": [ { "name": "list_brands", "title": "List your brands", "description": "The brands in your workspace, the most recently changed first, with the total. Each one says its current version and whether a change waits for approval. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "get_brand", "title": "Read a brand", "description": "A brand with its draft: the masters (brand.json) as last saved, the draft's rev, the current version and any change waiting for approval. Send the rev back when you save or approve. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "create_brand", "title": "Create a brand", "description": "Start a brand with a name, and the masters you drew so far if you have them. It starts as a private draft; nothing is public until an owner approves it. The slug comes from the name when you leave it out, and becomes the brand's address: ideare.app/b/. Costs no credits.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": false } }, { "name": "update_draft", "title": "Save the draft", "description": "Replace the draft's masters (brand.json). Send the draftRev you started from: if someone saved in between, you get a 409 with the current draft, so no change is lost. Saving publishes nothing. Costs no credits.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": false } }, { "name": "approve_draft", "title": "Approve the draft", "description": "From an owner or an admin: make the draft a new public version. Every file is drawn again and published at cdn.ideare.app/b//v/; follow the run to see it finish. From anyone else: ask the owner to approve this draft, which they do in one tap. Send the draftRev you looked at. Costs no credits.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": false } }, { "name": "check_brand", "title": "Check a brand", "description": "Check the draft the way an approval does: contrast, legibility at small sizes, text that fits, safe areas on every social size, and the copy rules. Each result says what to fix. Changes nothing. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "list_versions", "title": "List a brand's versions", "description": "Every approved version of a brand, newest first, with what changed in each. Versions are public: no key needed. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "get_version", "title": "Read a version", "description": "One approved version and every file in it, each with its address and sha256. Ask for `latest` to get the version the brand points at now: the CLI resolves it here, then fetches the files of that exact version. Versions are public: no key needed. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "restore_version", "title": "Bring back an older version", "description": "Put an older version's masters back in the draft and approve them as a new version, so the history only grows. From anyone but an owner or admin, this asks the owner to approve instead. Send the draft's current draftRev: the draft is replaced. Costs no credits.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": false } }, { "name": "list_files", "title": "List a brand's files", "description": "Every file of a version (the current one when you leave it out): logos, site icons, share cards, social sizes, tokens, the email signature, the business card. Each has its address, type, size and sha256. Pass a group (web, logo, og, social, tokens, registry, docs, email, print) to get one folder. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "render_template", "title": "Draw a template", "description": "Draw one of the brand's post templates with your words, as PNG or JPEG, and get a link to it that works for an hour. Templates: promotion, hours, menu, pix (send the Pix key), new-product, status-offer and carousel (5 pages). Sizes: ig-post, ig-square, ig-story, wa-status and share-card. Words that don't fit are refused, with which slot to shorten. Uses the draft unless you name a version. Costs no credits, within the hourly render allowance.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "get_run", "title": "Read a run", "description": "Where a long job stands (drawing a version's files, AI pictures, an import): queued with its place in line, running, or finished with its result or what went wrong. For live updates, open its eventsUrl as Server-Sent Events. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "cancel_run", "title": "Stop a run", "description": "Stop a run that is queued or running. Credits for pictures not made yet come back. A version's cascade can't be stopped: once approved, its files finish. Answers the run as it stands.", "annotations": { "readOnlyHint": false, "destructiveHint": true, "openWorldHint": false } }, { "name": "generate_text", "title": "Suggest names and words", "description": "Suggestions from what the business does: names, taglines in each of the brand's languages, a voice, palette moods and font tags. Free, within a daily allowance (see get_usage).", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": true } }, { "name": "generate_symbols", "title": "Make AI symbol ideas", "description": "Draw up to 4 symbol ideas for the brand with AI: vector, no letters, in its colors. Costs 1 credit per idea, taken when the run starts and given back for each one that fails. Answers with the run; each idea arrives as an event.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": true } }, { "name": "generate_art", "title": "Make AI art", "description": "Draw a picture in the brand's own style with AI, from your prompt and the brand's references. A 1k draft costs 1 credit and a 2k keeper costs 2, taken when the run starts and given back if it fails. Answers with the run.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": true } }, { "name": "import_link", "title": "Read a brand from a link", "description": "Read a site or a social profile and pull out the name, the about text, up to 6 colors and the logo, in about 20 seconds. The logo comes as it was and as a clean vector. Free, within a daily allowance. Answers with the run; its result is what it found, to start a brand from.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": true } }, { "name": "import_files", "title": "Read a brand from your files", "description": "Read uploaded logos and pictures: find their colors and trace a logo into a clean vector, always next to your original. Upload first with create_upload. Free, within a daily allowance. Answers with the run.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": false } }, { "name": "import_folder", "title": "Read a whole brand folder", "description": "Sort a brand folder or zip you already uploaded (up to 200 files): logos in every version, fonts, a guide PDF, posts and photos. Code reads each file first, then AI looks at the pictures and reads the guide. Each file comes back with the slot it fits and how sure we are, and nothing changes in a brand until you call apply_import. Free, within the daily import allowance. Answers with the run; read it with get_folder_import.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": true } }, { "name": "get_folder_import", "title": "See a folder import", "description": "Where a folder import stands and, once it is read, where each file goes: its slot, how sure we are, the questions to answer, and what the guide said. Each picture has a link that works for an hour. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "apply_import", "title": "Use a folder import", "description": "Write a read folder into the brand: every file goes to its slot, with your moves made (a file moved into a logo slot sends the one there back to your files). For a brand, send its draftRev; without one, a new brand is made with `name`. Fonts ideare's catalog doesn't have stay private and are never published: list the ones you hold a license for in `licensed`. Only the draft changes: approve it to publish. Costs no credits.", "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": false } }, { "name": "list_assets", "title": "List your files", "description": "The files in your workspace's library, newest first: uploads, imported pictures, AI symbols and art. Each has a link that works for an hour. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "check_names", "title": "Check if a name is free", "description": "For up to 5 names, see whether the domains (.com.br, .com and .app unless you say) and the social handles look free, with links to search trademarks at INPI, USPTO and EUIPO. `available` means no record was found, not that it is yours; `unknown` means nobody answered. Each name whose handles are checked uses one of the day's handle checks. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": true } }, { "name": "get_usage", "title": "See your credits", "description": "This month's credits: what your plan includes, what you used, the credits you bought, the welcome credits a new account starts with and when they expire, and what is left. Also today's text suggestions and imports against their daily allowance, and when each resets. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "list_designs", "title": "List your designs", "description": "Your posts and other designs, the most recently changed first. Pass a brand to see only its designs. Costs no credits.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } }, { "name": "render_design", "title": "Export a design", "description": "Draw one page of a design as PNG or JPEG, with the brand's draft, and get a link to it that works for an hour. Costs no credits, within the hourly render allowance.", "annotations": { "readOnlyHint": true, "destructiveHint": false, "openWorldHint": false } } ] } ] }