{"id":"io.github.hermoso-ai/hermoso","slug":"io-github-hermoso-ai-hermoso","title":"Hermoso","description":"AI marketing agent: 1427 tools, usable alone. Start free: 160+ free credits. No markup on models.","version":"0.1.610","publisher":{"kind":"github","id":"hermoso-ai","label":"@hermoso-ai on GitHub","url":"https://github.com/hermoso-ai"},"website":"https://hermoso.ai/mcp/","repository":"https://github.com/hermoso-ai/hermoso","remotes":[{"type":"streamable-http","url":"https://app.hermoso.ai/mcp?src=registry"}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"hermoso","version":"0.1.610","runtimeHint":"npx","transport":{"type":"stdio"},"packageArguments":[{"description":"Run the Hermoso stdio MCP server","type":"positional","value":"mcp"}],"environmentVariables":[{"description":"Hermoso agent key (hmk_…) from app.hermoso.ai, on the MCP & CLI tab under Terminal & API keys. Required against the hosted app.","isSecret":true,"name":"HERMOSO_TOKEN"},{"description":"Hermoso API origin. Defaults to https://app.hermoso.ai; set http://localhost:3000 to run against your own server.","name":"HERMOSO_API_BASE"}]}],"published":"2026-11-19","updated":"2026-11-19","status":"online","auth":"","latency_ms":1055,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"enable_tools","title":"Turn on more Hermoso tools","description":"LIST a group of tools that is not in this session's roster. IT IS NOT HOW YOU REACH A TOOL — call_tool runs any Hermoso tool whether or not it is listed, and that works everywhere. Use this when the session will use MANY tools from one area and you want them in your list. WORKS ON CLIENTS THAT RE-READ THE TOOL LIST (stdio, the CLI, Cursor, Claude Code); a host that fixed its roster at connect time","read_only":false},{"name":"get_instructions","title":"Read Hermoso's full instructions","description":"Free. Hermoso's instructions on demand: a topic (areas, instagram, capabilities, roster, safety, credits, setup, all) for the rest of the session instructions, any tool's name for its FULL rules, or \"paid-calls\" for get_cost, expected_credits, idempotency_key, revision and context.","read_only":true},{"name":"find_tools","title":"Find a Hermoso tool by name or task","description":"Search EVERY Hermoso tool — your starting list is deliberately short, and everything else in the product is here — by name, task or group. Each row gives the tool's PARAMETERS in one line, its CREDIT COST (free means free on every plan; a tool that runs a model quotes the live per-model figure) and its recent HEALTH on this server (failure rate and typical duration, or \"no recent calls\", which mea","read_only":true},{"name":"call_tool","title":"Run any Hermoso tool by name","description":"Run ANY Hermoso tool by name — including the paid-campaign, analytics and channel-admin tools that are not in this session's starting list — with the same permissions, the same account and the same result as calling it directly. Get the exact `name` and its `args` from find_tools first. This is the route on hosts that cannot reload their tool list mid-conversation (claude.ai, ChatGPT): enable_tool","read_only":false},{"name":"post_to_bluesky","title":"Post to Bluesky","description":"Use this when the user wants to post to Bluesky. Publishing costs no credits. Publish a post to Bluesky as the connected account. Text up to 300 characters — Bluesky ALSO caps a post at 3000 UTF-8 bytes, so an emoji-heavy post can be under 300 characters and still be refused; Hermoso checks both and says which limit. Bluesky requires a CONFIRMED EMAIL on the account before it will process any vide","read_only":false},{"name":"post_to_telegram","title":"Post to Telegram","description":"Use this when the user wants to post to a Telegram channel or group. Publishing costs no credits. Publish to a Telegram channel, group or chat as the brand's own bot. WHICH CHAT IS ALWAYS REQUIRED AND IS NEVER GUESSED: pass chatId as the public channel's @username (e.g. @yourchannel) or its numeric id (a group is negative; a supergroup or channel starts with -100). THE BOT MUST BE IN THE CHAT — an","read_only":false},{"name":"list_telegram_chats","title":"Find Telegram chat ids","description":"Find the chat ids this Telegram bot can be addressed by. STATE THE LIMIT WHENEVER YOU USE IT: this is NOT the list of chats the bot belongs to — the Bot API publishes no such method — it is every chat that SENT the bot an update in the last 24 hours, which is as long as Telegram keeps an update. A channel the bot posts to every day but nobody messages will NOT appear here, and its absence means no","read_only":true},{"name":"post_to_wordpress","title":"Publish a WordPress blog post","description":"Use this when the user wants to publish, draft or schedule a BLOG POST on their WordPress site. Publishing costs no credits. A title is REQUIRED and the text becomes the body: plain text or light markdown (## headings, - lists, **bold**, [links](url)) is turned into WordPress blocks, and HTML is sent as written. status: publish (default), draft, pending (submit for review), private (logged-in edit","read_only":false},{"name":"post_to_shopify_blog","title":"Publish a Shopify blog article","description":"Use this when the user wants to publish, draft or schedule a BLOG ARTICLE on their Shopify store's blog. Publishing costs no credits. Works for the Shopify store connected to this brand (Connectors ▸ Shopify, or connect_shopify_store) or the store this account was installed on. A title is REQUIRED and the text becomes the body: plain text or light markdown (## headings, - lists, **bold**, [links](","read_only":false},{"name":"post_to_webflow","title":"Publish a Webflow blog post","description":"Use this when the user wants to publish or draft a BLOG POST on their Webflow site. It becomes an item in the site's blog CMS collection. Publishing costs no credits. A title is REQUIRED and the text becomes the body: plain text or light markdown becomes HTML in the collection's rich text field, and HTML is sent as written (Webflow's API cannot take code blocks, so a body with one is refused). Her","read_only":false},{"name":"post_to_wix","title":"Publish a Wix blog post","description":"Use this when the user wants to publish, draft or schedule a BLOG POST on their Wix site. Publishing costs no credits. A title is REQUIRED (up to 200 characters) and the text becomes the body: plain text or light markdown is turned into Wix's own rich content, and HTML is converted by Wix (up to 30,000 characters). status: publish (default), draft, or scheduled with a future `date`, which Wix sche","read_only":false},{"name":"post_to_discord","title":"Post a Discord announcement","description":"Post to the user's Discord server. Free. With the Hermoso bot added it posts as the bot to channel (or the brand's default channel) with attachments up to 25 MB a message, replyTo, threadId (inside a thread), startThread (a thread under the post) and threadName (a forum channel); the messageId it returns (\"<channel>/<message>\") is what edit, delete and get_discord_message take. Without the bot it ","read_only":false},{"name":"post_to_slack","title":"Post a Slack announcement","description":"Post to the user's Slack. Free. With the Hermoso app installed it posts as the app to channel (or the brand's default channel), uploads images and video, replies in a thread (threadTs) or schedules in Slack (postAt, text only, ≤120 days); the messageId it returns (\"<channel>/<ts>\") is what edit_slack_message, delete_slack_message and get_slack_message take. Without the app it posts through the bra","read_only":false},{"name":"hermoso_capabilities","title":"Hermoso models, options and credit costs","description":"Probe what this Hermoso account can do RIGHT NOW: available image/video model ids + their credit costs (estimates: a render is charged its actual cost), aspect ratios, video durations, the recipe ids, and the canEdit/canAvatar flags. Call it when you need a specific model id, a credit cost, or a capability you are not sure of. It is NOT a prerequisite for rendering: generate_image, generate_video ","read_only":true},{"name":"hermoso_credits","title":"Credit balance","description":"Return the credit balance, recent priced calls with their credits, and costModel (the one-sentence rule of what costs credits). THE RULE: only AI model runs and Ad Spy research spend credits; publishing, scheduling, ads management, analytics, comments, DMs and connectors cost no credits on any plan (X is the single per-call exception; xCost gives its exact credits per post, with and without a link","read_only":true},{"name":"buy_credits","title":"Buy credits","description":"Out of credits? Top up with a credit PACK. Call with no argument to list the available packs (id · credits · price). If the account has a saved card and you have billing-admin rights, calling with `pack` quotes the exact charge and calling again with confirm:true AND the quote's quote_token charges the saved card instantly (same one-click top-up as the app — no redirect). If there's no saved card ","read_only":false},{"name":"report_bug","title":"Report a bug","description":"Report a bug in Hermoso to the team. Use this when something in Hermoso genuinely misbehaves — a tool errors unexpectedly, returns a wrong or malformed result, a render comes back broken, or documented behaviour doesn't match what happened. Include what you were trying to do, the exact tool call and arguments, and what came back. Do NOT use it for out-of-credits, a policy refusal, or a missing cap","read_only":false},{"name":"request_feature","title":"Request a feature","description":"Ask the Hermoso team for a capability that doesn't exist yet. Use this when you need something Hermoso genuinely can't do — an unsupported platform or channel, a missing model, an export format, a tool that would have completed the user's task but isn't available. Say what the user was trying to achieve, not just the feature name — the use case is what gets built. Free, no credits.","read_only":false},{"name":"contact_support","title":"Contact Hermoso support","description":"Message Hermoso's human support team for the user: billing, account or sign-in problems, a connector that will not connect, or a question the tools cannot answer. Use the user's words. The team replies by email to the account's address (the result names it). Defects you found: report_bug. Missing capabilities: request_feature. Free.","read_only":false},{"name":"billing_status","title":"Billing status","description":"Show this account's billing at a glance: current plan (quote plan.priceUsd per plan.period), credit balance, whether auto-reload is on, whether a card is on file, and whether YOU (this key) have ADMIN rights to change billing. Read-only, free. Call it before upgrade_plan / set_auto_reload to know what's possible — members have read-only billing. IN A SHARED TEAM WORKSPACE A MEMBER SEES THE PLAN AN","read_only":true},{"name":"upgrade_plan","title":"Upgrade plan","description":"Change the SUBSCRIPTION plan (admin only). No argument lists the monthly plans. Basic ($19.99) is the posting plan: Autopilot, plus unlimited posting and scheduling with NO monthly credits (it includes the same 160+ free credits as the Free plan, and monthly credits start on Starter). Starter, Pro and Studio include monthly credits and no markup on models. Every paid plan posts without a limit (Fr","read_only":false},{"name":"set_auto_reload","title":"Set auto-reload","description":"Turn automatic credit reloads on or off (admin only): when the balance drops below a threshold, the card on file is charged for a top-up pack — SERVER-SIDE, even with no app open. Requires a saved card, added once in the app at first checkout/top-up; if there's none the tool tells you exactly where to add it. After that one-time card setup, agents can manage auto-reload, top-ups and plan links ful","read_only":false},{"name":"list_brands","title":"List profiles","description":"List every profile on this account (id + name; a profile is a brand, a creator or a personal workspace) and which one this connection acts on, PLUS any profile another account shared with you. Call this, then use_brand to switch; a SHARED profile switches the same way (pass its name or the profile id printed here). If a profile looks empty when the app shows it full, you are acting on a different ","read_only":true},{"name":"use_brand","title":"Switch profile","description":"Pin which profile this connection acts on. Pass the profile id or exact name from list_brands. Works for your own profiles AND one another account SHARED with you (pass its name or the profile id list_brands prints); access is verified against your real membership before it is pinned. Persists for this API key until changed, on every surface (hosted connector included — no environment variables, n","read_only":false},{"name":"create_brand","title":"Create a profile","description":"Add a NEW profile (a brand, client, creator or personal workspace) and switch to it. Each has its OWN brand details, memory, swipefile, Library, avatars, skills, playbooks and connectors; nothing leaks between them. Use draft_brand to FILL it and update_brand to edit it. Re-running with the same name returns the existing profile instead of a duplicate. Creating it is free. Drafting a NEW brand int","read_only":false},{"name":"delete_brand","title":"Delete a profile","description":"PERMANENTLY delete a profile and EVERYTHING in it — brand details, memory, swipefile, Library creations, generated assets, avatars, skills, playbooks, chats — and disconnect its connected accounts. Irreversible, and it applies to everyone the workspace is shared with. Call it WITHOUT confirm first: it reports exactly what that workspace holds. Show the user that inventory verbatim, get an unambigu","read_only":false},{"name":"list_meta_pages","title":"List Meta pages & ad accounts","description":"List the Facebook Pages (with any linked Instagram business account) and ad accounts on the connected Meta account — use before post_to_meta / create_meta_campaign to pick the target. Requires the user to have connected Meta (Connectors > Meta); returns a connect hint if not.","read_only":true},{"name":"upload_file","title":"Upload a local file -> durable public URL","description":"Persist an ARBITRARY user file (image, video, audio, PDF or document, up to 150MB) into Hermoso and get back a durable public URL that EVERY publish, schedule and ad-build tool accepts — post_to_meta / post_to_linkedin / post_to_linkedin_page / post_to_youtube / post_to_tiktok / post_to_pinterest / post_to_x / post_to_google_business / schedule_post / upload_meta_asset / upload_google_ads_asset / ","read_only":false},{"name":"list_whatsapp_accounts","title":"WhatsApp Business accounts and numbers","description":"The WhatsApp Business Accounts SHARED WITH THIS PROFILE and the phone numbers registered on each — the ids every other WhatsApp tool needs, plus each number’s QUALITY RATING, which is what decides how many messages Meta will let it send. Start here. A WABA with no number cannot send anything and the reply says so: Hermoso does not register or verify numbers, that is WhatsApp Manager. A business po","read_only":true},{"name":"post_to_meta","title":"Post to Facebook, Instagram or Threads","description":"Use this when the user wants to post now to Facebook, Instagram or Threads. Publish to a connected Facebook Page, its linked Instagram, OR the brand’s Threads account — text/link/image/VIDEO/CAROUSEL. A MULTI-SLIDE creative is a CAROUSEL, not several posts: pass the slides in order as imageUrls[] and they publish as ONE swipeable post (Instagram album, Threads carousel, Facebook multi-photo post).","read_only":false},{"name":"schedule_post","title":"Schedule a post for later","description":"Use this to schedule a social media post for later, on one channel or several. Costs no credits (X alone bills per call: hermoso_credits). FREE PLAN: 5 posts a month on up to 3 channels (a post counts once; UTC month); paid plans are unlimited. Over it the post is refused and nothing is queued: relay the refusal as written, never retry or split the post. A MULTI-SLIDE creative goes in imageUrls[] ","read_only":false},{"name":"list_scheduled","title":"List scheduled and past posts","description":"Use this when the user asks what is scheduled, what already posted, or whether a post went out. Show what is queued to post and what already went out. Each fired item reports PER-CHANNEL outcomes, so you can see that (say) Instagram published and TikTok failed on the same item rather than a single misleading verdict. Past items are rebuilt from published-post records, one row per channel; they are","read_only":true},{"name":"reschedule_post","title":"Change a scheduled post","description":"Change a post that is still QUEUED — move it to a different time, rewrite the caption, swap the media, add or drop a channel, or change which board / Page / company Page / listing it goes to. PASS ONLY WHAT CHANGES: an omitted field is left exactly as it was, and an explicit empty string CLEARS one (linkedinOrganizationId:\"\" moves a company-Page post back to the person’s own profile). The edited i","read_only":false},{"name":"cancel_scheduled","title":"Cancel a scheduled post","description":"Remove a queued post before it goes out. Get the id from list_scheduled. Only works while it is still queued — something already published cannot be unsent (use manage_meta_post to delete a Facebook/Instagram post after the fact).","read_only":false},{"name":"retry_scheduled","title":"Retry a failed scheduled post","description":"Send a post that FAILED again. A scheduled post fans out across its channels INDEPENDENTLY, so a failure is usually PARTIAL — LinkedIn 401s while Instagram published fine — and this re-fires ONLY the channels that did not succeed by default (list_scheduled reports them as `retryable`). It re-queues the same content as a NEW post that goes out RIGHT AWAY — the queue picks it up on its next pass, wi","read_only":false},{"name":"instagram_posting_hold","title":"See or resume a held Instagram account","description":"See or lift the HOLD on an Instagram account's scheduled posts. When Meta refuses two posts in a row from an Instagram account with its spam restriction (code 4/2207051, \"We restrict certain activity to protect our community\"), Hermoso holds that account's scheduled Instagram posts instead of sending them into the restriction: they stay queued and nothing is posted. action:\"status\" (default) says ","read_only":false},{"name":"duplicate_scheduled","title":"Duplicate a scheduled post","description":"Copy an existing scheduled or already-published post into a NEW queued post — the way to run a creative again, reuse a post that worked as the starting point for the next one, or re-send something after it went out. It copies the caption, media, per-channel captions, title, description, tags and the target board / Page / company Page / listing, and ANY of those can be overridden in the same call. ","read_only":false},{"name":"get_post_refill","title":"Autopilot posting status","description":"Show AUTOPILOT POSTING (autoposting, the posting refill) for this profile — \"is autopilot on?\", \"what is waiting for review?\": whether it is on, its mode (review = each batch of fresh posts waits as drafts for approval; auto = fresh posts are scheduled straight away), WHICH CHANNELS it posts to with each one’s posts per day and posting times, roughly what it costs a day, when it next runs, how man","read_only":true},{"name":"set_post_refill","title":"Set up, change or pause autopilot posting","description":"Turn AUTOPILOT POSTING (autoposting, the posting refill) on, change it or pause it. Available on paid plans: on the Free plan switching it on is refused, so relay that and do not retry. PASS ONLY WHAT CHANGES. It always makes NEW posts (a fresh image, carousel or video for each) and never re-posts the Library. Ask the user for anything missing (goal, mode, channels) rather than guessing. `mode` pi","read_only":false},{"name":"run_post_refill","title":"Run autopilot now / approve its drafts","description":"Run AUTOPILOT POSTING (autoposting, paid plans only) NOW instead of waiting for its daily turn, or review the drafts it made: schedule them, delete one, change a caption, or save a note such as \"too salesy\". By default it is a preview: it returns the posts it WOULD make — each new picture’s scene, the caption, the channels and the price — rendering nothing and queueing nothing. The preview still W","read_only":false},{"name":"post_to_linkedin","title":"Publish to LinkedIn","description":"Use this when the user wants to post to their personal LinkedIn profile. Publishing costs no credits. Publish a post to the user’s connected LinkedIn profile — text, and optionally an image (imageUrl), a VIDEO (videoUrl, with captionsSrt and a videoThumbnailUrl cover), a 2–20 image MULTI-IMAGE post (imageUrls), a LINK post with a real preview card (linkUrl + linkTitle / linkDescription / linkThumb","read_only":false},{"name":"post_to_x","title":"Publish a post to X (Twitter)","description":"Use this when the user wants to post to X (Twitter) now. Publish to the user’s connected X (Twitter) account — a single post, a post with an image or video render attached, a reply to an existing post, or a whole THREAD (pass `thread` as an array and each part is posted as a reply to the one before). This PUBLISHES immediately and PUBLICLY — ALWAYS show the user the exact text and get an explicit ","read_only":false},{"name":"post_x_article","title":"Publish a long-form Article to X","description":"Publish a long-form ARTICLE to the user’s connected X (Twitter) account — X’s own long-form format, which is a different thing from a long POST. THE HARD LIMIT TO PLAN AROUND: X allows only about 10 Article DRAFTS and 5 Article PUBLISHES per account per DAY, it publishes that cap nowhere, and it counts a FAILED attempt against them — so never iterate on an article by republishing it, and use `publ","read_only":false},{"name":"list_pinterest_boards","title":"List Pinterest boards","description":"List the boards on the user’s connected Pinterest account — id, name, privacy and pin count. ALWAYS call this before post_to_pinterest and let the USER pick: Pinterest requires a board and Hermoso never chooses one for them. Read-only, 0 credits. Needs Pinterest connected (Connectors > Pinterest).","read_only":true},{"name":"post_to_pinterest","title":"Create a Pin","description":"Use this when the user wants to publish a Pin to Pinterest. Publishing costs no credits. Create a Pin on one of the user’s Pinterest boards from any finished visual they have — image, video, or a 2–5 slide CAROUSEL (pass the slides in order as imageUrls[] and Pinterest publishes one swipeable Pin). Title, description and destination link ride along. The link is what makes a Pin drive traffic, so a","read_only":false},{"name":"list_business_locations","title":"List Google business listings","description":"List the Google Business Profile listings SHARED WITH THIS PROFILE — id, title, address, website and Maps link. These are the only listings anything here can post to or read: one Google login often manages several businesses (an agency manages its clients’), and the user ticks which of them belong to this profile. Call this before posting whenever more than one is shared and let the USER pick: a P","read_only":true},{"name":"post_to_google_business","title":"Post to Google Business Profile","description":"Publish a Post to the brand’s Google Business Profile — the panel that appears on Google Search and Maps for the business. Text, optionally ONE PHOTO, and a call-to-action button. Google’s Posts API accepts NO VIDEO, so pass a still image. This PUBLISHES immediately and publicly on the business listing — show the user the exact text, photo and button and get an explicit yes BEFORE calling. If the ","read_only":false},{"name":"post_to_youtube","title":"Post a video to YouTube","description":"Use this when the user wants to upload a video or Short to YouTube. Publishing costs no credits. Publish a finished video to the brand’s connected YouTube channel. Pass a Hermoso render URL (or an upload_file url for a local/external file). PUBLISHES PUBLICLY BY DEFAULT: a plain \"post this to YouTube\" puts it ON the channel (confirm the title with the user, as for any publish) and notifies subscri","read_only":false},{"name":"post_to_tiktok","title":"Post a video or photo post to TikTok","description":"Use this when the user wants to post a video or photo post to TikTok now. Publishing costs no credits. Publish to the user’s connected TikTok account — a finished VIDEO, or a PHOTO POST (TikTok’s photo/slideshow format). A photo post carries 1 to 35 images and ONE image is simply a one-slide photo post, so there is nothing special to do for a single picture: pass imageUrls, in the order the slides","read_only":false},{"name":"tiktok_post_status","title":"Check whether a TikTok post finished publishing","description":"Follow a TikTok post that post_to_tiktok sent but TikTok was still processing (it came back pending:true). Pass the publishId it returned. Answers one of three states: done (PUBLISH_COMPLETE, with the public `url` once TikTok’s moderation has named it; `urlStatus` is ready, pending, private or draft), failed (with TikTok’s reason), or still processing, which is normal for a few minutes and is NOT ","read_only":true},{"name":"publish_to_shopify_product","title":"Publish an image or video onto a Shopify product","description":"Attach a finished IMAGE or VIDEO to one of the merchant's Shopify product listings, as product media. Pass productId (from list_shopify_products, the gid://shopify/Product/… form) and a PUBLIC https mediaUrl, which is what every Hermoso render returns. Whether it is a video is read from the file (.mp4 / .mov / .webm, or the link's content type); pass kind to say so outright. An image is fetched by","read_only":false},{"name":"send_sms","title":"Send an SMS or MMS","description":"Send a text from one of the brand's own Twilio or Telnyx numbers: to (one number or a list of up to 100, E.164), text (up to 1,600 characters), media (up to 10 pictures for an MMS: a Library id, attachment://N or an https link), from (needed when the account has several numbers), sendAt (ISO time, to schedule it; on Twilio this needs a Messaging Service set with set_sms_settings). The answer has e","read_only":false},{"name":"list_linkedin_pages","title":"List the LinkedIn company Pages this account administers","description":"List the LinkedIn COMPANY PAGES the connected account administers — id, name and the role held on each. ALWAYS call this before post_to_linkedin_page when there is more than one Page: publishing to the wrong company Page is a public mistake and Hermoso never chooses for the user. If it comes back empty, the account holds no Page admin role, or LinkedIn has not granted this app the organization sco","read_only":true},{"name":"post_to_linkedin_page","title":"Publish to a LinkedIn company Page","description":"Use this when the user wants to post to a LinkedIn company Page. Publishing costs no credits. This is a DIFFERENT thing from post_to_linkedin, which publishes to the person’s own profile: pick the one the user actually asked for and never substitute. organizationId comes from list_linkedin_pages; omit it only when the account administers exactly one Page. This PUBLISHES immediately and PUBLICLY — ","read_only":false},{"name":"list_linkedin_lead_forms","title":"List LinkedIn lead gen forms","description":"The LEAD GEN FORMS a LinkedIn company Page or ad account owns — id, name, state, version and the fields each one asks for (firstName, email, company …). Make a new one with create_linkedin_lead_form; edit or archive one with update_linkedin_lead_form. If it answers that the connection must be reconnected, say exactly that: the lead-sync permission is granted at authorise time. Read-only, free.","read_only":true},{"name":"list_linkedin_leads","title":"List LinkedIn leads (form responses)","description":"The LEADS a LinkedIn lead gen form collected — every response with its answers keyed by field (firstName, lastName, email, company, …), the campaign and creative that produced it, the consents ticked, and whether it was a test lead. Newest first. Filter by formId, a since/until window (ISO date or epoch ms — LinkedIn takes epoch), or testLeadsOnly. THIS IS PERSONAL DATA: show it to the user, hand ","read_only":true},{"name":"get_linkedin_lead","title":"Read one LinkedIn lead","description":"One LinkedIn lead by id (from list_linkedin_leads), with every answer named by field. Personal data — show, never republish. Read-only, free.","read_only":true},{"name":"subscribe_linkedin_leads","title":"Turn on real-time LinkedIn lead delivery","description":"Have LinkedIn push every new lead to Hermoso the moment it is submitted, and optionally relay each event on to the user’s own CRM. THE WEBHOOK LINKEDIN VALIDATES IS ALWAYS HERMOSO’S OWN: LinkedIn challenges it with our app secret (and re-challenges every ~2 hours), which no CRM, Zapier or Make endpoint can answer — so never promise a customer URL as the LinkedIn webhook. Pass forwardTo (public HTT","read_only":false},{"name":"list_linkedin_lead_events","title":"LinkedIn lead events received in real time","description":"The lead events LinkedIn has PUSHED to Hermoso for this brand (new lead / deleted lead, with the form and the lead id), newest first. Empty means none have arrived, not that none exist — list_linkedin_leads reads every lead regardless, and subscribe_linkedin_leads is what starts delivery. Read a lead’s answers with get_linkedin_lead. Read-only, free.","read_only":true},{"name":"list_linkedin_lead_subscriptions","title":"List LinkedIn lead webhooks","description":"The lead notification webhooks registered on a LinkedIn Page or ad account, with the id delete_linkedin_lead_subscription takes. Read-only, free.","read_only":true},{"name":"delete_linkedin_lead_subscription","title":"Stop a LinkedIn lead webhook","description":"Remove a lead notification webhook (subscriptionId from list_linkedin_lead_subscriptions). Leads themselves are unaffected and stay readable; only the real-time delivery stops. Read back from LinkedIn. Free.","read_only":false},{"name":"save_to_drive","title":"Save file(s) to Google Drive","description":"Save a Hermoso render — or ANY file — into the user’s connected Google Drive. Pass a Hermoso render URL as url (or urls[] for several); for a local/external file, call upload_file first and pass the url it returns. Optional folder (created if new) + name. Returns the Drive file(s) with a webViewLink. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets and ","read_only":false},{"name":"import_from_cloud","title":"Import a Drive / OneDrive folder into the Library","description":"Pull the files in a Google Drive or OneDrive FOLDER into this profile's Library, so they can be used like anything rendered here — published, scheduled, cloned, used as a product photo or a reference. Hermoso downloads each file with the user's own connected account (a Drive/OneDrive file is not public) and stores a durable Hermoso url for each. Give `folderId` from list_drive_files / list_onedriv","read_only":false},{"name":"list_drive_files","title":"List Google Drive files","description":"List the Google Drive files & folders Hermoso can reach: the ones it created plus any the user picked with the Google file picker in the app (drive.file, never their whole Drive). This is how you find a picked file's id. Filter by query (name contains …), folderId, or onlyFolders:true; paginate with pageToken. Read-only. A FOLDER: picking a folder hands over the folder alone, not its files, so a f","read_only":true},{"name":"get_drive_file","title":"Get a Drive file’s details","description":"Fetch one Drive file’s metadata — name, type, size, modified time, a webViewLink to open it and a webContentLink to download it. Pass fileId (from list_drive_files). Read-only.","read_only":true},{"name":"update_drive_file","title":"Rename / move / trash a Drive file","description":"Update a Drive file: rename (name), move it into a folder (moveToFolderId, optionally removeFromFolderId to move OUT of the old one), or trash / untrash it (trash:true|false). Pass fileId (from list_drive_files). To delete permanently, use delete_drive_file.","read_only":false},{"name":"delete_drive_file","title":"Delete a Drive file","description":"Delete a Drive file. By default it goes to Trash (recoverable); pass permanent:true to delete it forever. Pass fileId (from list_drive_files) + confirm:true. Irreversible when permanent — confirm with the user first.","read_only":false},{"name":"create_drive_folder","title":"Create a Drive folder","description":"Create a folder in the user’s Google Drive (optionally nested under parentId) to organize saved files. Returns the folder id + webViewLink. Use that ID as update_drive_file’s moveToFolderId or as parentId for a nested folder. NOTE: save_to_drive’s `folder` is a NAME, not this id — it find-or-creates a folder by that name, so pass the folder NAME there (or omit and just save, then move with update_","read_only":false},{"name":"create_sheet","title":"Create a Google Sheet","description":"Create a new Google Spreadsheet in the user’s Drive and optionally fill it with rows — e.g. export a swipefile, ad list, or performance report. Pass rows as an array of row arrays (first row = headers). Returns the spreadsheet id + URL. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets and Docs).","read_only":false},{"name":"append_to_sheet","title":"Append rows to a Google Sheet","description":"Append rows to a Google Sheet Hermoso can reach — one it created (pass the spreadsheetId from create_sheet) or one the user handed over with the Google file picker in the app (find its id with list_drive_files). rows = array of row arrays.","read_only":false},{"name":"read_sheet","title":"Read a Google Sheet range","description":"Read cells from a Google Sheet Hermoso can reach — one it created, or one the user handed over with the Google file picker in the app (that is how an EXISTING spreadsheet becomes readable; find its id with list_drive_files). Pass the spreadsheetId (from create_sheet) OR paste a Google Sheets URL as sheetUrl. If Google answers that the file was not found, the user has not picked it yet — ask them t","read_only":true},{"name":"export_swipefile_deck","title":"Swipefile to Google Slides","description":"Turn a SWIPEFILE COLLECTION into a real Google Slides deck — one slide per saved ad, carrying the creative, the brand, the ad copy, the run dates with the run length, and the platform. This is the thing a marketer actually presents to a client or a team. Returns the presentation id + URL. Creates a NEW deck every time: under the drive.file scope Hermoso can only touch files it created, so it canno","read_only":false},{"name":"list_notion_pages","title":"List Notion pages","description":"Find the Notion pages and databases the user shared with Hermoso, by title, newest edited first. Gives the page id that save_to_notion, append_to_notion_page and read_notion_page take, or the database id to save rows into. Read-only, free. Needs Notion connected (Connectors > Notion).","read_only":true},{"name":"save_to_notion","title":"Save to Notion","description":"Save to the user's Notion as a NEW page: a research report, competitor teardown or campaign report as `content` (markdown: headings, lists, links, and an image or video URL on its own line becomes the media), a swipefile collection (swipefileCollection: name or id; each ad with its creative, copy, run dates and link), the content calendar (includeSchedule:true), or a mix. Put it under parentPageId","read_only":false},{"name":"append_to_notion_page","title":"Add to a Notion page","description":"Add to the END of an existing Notion page (pageId or its link, from list_notion_pages): markdown content, a swipefileCollection, or includeSchedule:true. Nothing already on the page changes. Free.","read_only":false},{"name":"read_notion_page","title":"Read a Notion page","description":"Read a Notion page the user shared with Hermoso, as markdown (pageId or a Notion link). A database id answers with its data sources instead. Read-only, free.","read_only":true},{"name":"export_schedule_to_notion","title":"Export the schedule to Notion","description":"Export the posting schedule to a Notion database, one row per post: date, channels, caption, media link and status. Creates a new database (under parentPageId, or private in the workspace) or writes into an existing one (databaseId), matching its columns by name. historyDays adds posts already published. Up to 100 rows per run; the answer says if more were left. Free.","read_only":false},{"name":"query_notion_database","title":"Read a Notion database","description":"Read the ROWS of a Notion database the user shared with Hermoso — e.g. the team's content calendar: each row's title, id, link and every property as a plain value (status, date, channels, caption, links), plus the database's columns with their types and options. Filter with match {\"Status\": \"Scheduled\"} (typed from the database's own columns) or a raw Notion filter object; sort with sortBy (a colu","read_only":true},{"name":"update_notion_row","title":"Update a Notion database row","description":"Change properties on ONE row of a Notion database (pageId from query_notion_database) — e.g. mark a calendar row Status \"Posted\" and put the live post link in its URL column. properties is {\"Column\": value} by column name: text, number, checkbox, select (an existing option or a new one), status (must be an existing option), multi-select (array; replaces the whole value), date (ISO, or {start, end}","read_only":false},{"name":"create_doc","title":"Create a Google Doc","description":"Create a new Google Doc in the user’s Drive with a title + optional body text — e.g. export ad copy, a creative brief, or a report. Returns the document id + URL. Needs Google Drive connected (Connectors > Google Drive — one connection covers Drive, Sheets and Docs).","read_only":false}],"server_info":{"name":"hermoso","version":"0.1.610"},"category":"productivity","tags":["social","communication","sales"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-16","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-hermoso-ai-hermoso/"}