Skip to main content
Glama

Server Details

Publish to Instagram from your AI assistant. Pith lets you publish your own images and captions, review and approve AI-generated drafts, rewrite captions, manage scheduled posts and update your brand voice through MCP. Supports stories, feed posts and carousels. Hosted Streamable HTTP endpoint with browser-based sign-in; no local installation or API key required. Publishing your own content is free; AI-generated content follows plan limits. Setup and documentation: https://pith.day/connect/mcp

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
OAuth
Works in Glama
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A3.6/5.0

Scored across 39 tools

Disambiguation4/5

Most tools target clearly distinct resources and actions, but a few pairs could be confused: publish_draft vs. publish_post (AI draft vs. own image), edit_schedule vs. update_draft for scheduling/approval, and get_tenant vs. whoami. The very detailed descriptions largely disambiguate these, making misselection uncommon.

Naming Consistency4/5

The vast majority of tools follow a consistent verb_noun snake_case pattern (add_asset, get_draft, set_flow, list_products, etc.). Minor deviations are brand_dna_drift (noun phrase with no verb) and whoami (question phrase), but the overall convention is predictable.

Tool Count2/5

39 tools is very heavy for an agent to manage, well beyond the typical 3-15 well-scoped range. While each tool has a distinct purpose in a feature-rich platform, many get_* and set_* tools could be consolidated into resource-oriented tools, reducing selection cost.

Completeness4/5

The surface covers the full lifecycle for drafts, scheduling, assets, Brand DNA, products, billing, onboarding, and events. Minor gaps exist, such as no explicit account-disconnect or published-post management tool, but these are not central and agents can work around them.

Publisher details

Operator
PITH · Publisher source
Vendor relationship
First-party
Privacy policy
Not provided
Restrictions
https://pith.day/terms · Publisher source

Available Tools

39 tools
add_assetAdd a photoAInspect

Import an image into the tenant's asset library, either from a public https URL (mirrored into our storage; the source can expire afterwards) or from raw base64 bytes via image_base64 (≤8MB decoded; use when you hold the image and there is no public URL). Exactly one of image_url / image_base64. Images below 720px on the short side are rejected: a story is 1080×1920 and a smaller photo ships blurry, so send the original, not a thumbnail or a web copy. Pass description/price for a product shot, and folder to file a batch together.

Inputs: context (required), price, folder, handle, +6 more.

brand_dna_driftApply or dismiss a drift proposalA
DestructiveIdempotent
Inspect

Resolve a pending Brand DNA drift proposal (see get_brand_dna for the pending one). action=apply adopts the proposed DNA; dismiss rejects it. Only the owner's explicit choice should drive this.

Inputs: action (required), context (required), drift_id (required), handle.

connect_instagramConnect an Instagram accountA
Idempotent
Inspect

Get a one-time link that connects the user's Instagram Business/Creator account to Pith so publish_post can post to it. No handle is needed: the account that gets connected is whichever one the user authorizes on Instagram, so call this as soon as whoami shows no accounts instead of asking the user for a username. Show the user the returned connectUrl exactly as given (do not rewrite or shorten it), tell them to open it and approve on Instagram, and when they say they're done call whoami to confirm. The link expires in 10 minutes and works once; call this tool again for a fresh one. Requires an Instagram professional account; personal accounts cannot use Instagram's publishing API.

Inputs: context (required), handle.

contact_supportAsk a person at PithAInspect

Send a message to a person at Pith on the user's behalf: for something broken that list_events doesn't explain, a billing or account question, or when the user asks for a human. Only send what the user wants sent, in their words or a faithful summary they agreed to. A person replies to the user by email, usually within a day.

Inputs: context (required), message (required), handle, language, +2 more.

curate_imagesCurate the scraped photo poolA
Destructive
Inspect

Trim the scraped Instagram photo pool to the entries worth generating from (off-brand photos in the pool produce weird stories). Pass what to KEEP: either image URLs (from get_tenant with include_scraped_images) or scraped:N ids (as returned by list_assets); mixing is fine. Everything else is removed, parallel quality metadata stays aligned, today's pending drafts are re-seeded from the curated pool. Refuses to empty the pool.

Inputs: keep (required), context (required), handle.

delete_assetDelete an uploaded photoA
Destructive
Inspect

Remove an uploaded asset from the library (scraped:N entries cannot be deleted here; curate_images manages the scraped pool).

Inputs: context (required), asset_id (required), handle.

download_draft_imageGet a story image for manual postingA
Idempotent
Inspect

Resolve the rendered story image URL for save-and-post-yourself. COUNTS toward the Free monthly AI-stories cap on the first call per draft (already published/downloaded drafts are free to re-fetch). A cold render can take 60-90 seconds.

Inputs: context (required), draft_id (required), handle.

edit_scheduleAdd / update / remove scheduled postsA
Destructive
Inspect

Manage scheduled posts. action=add creates a scheduled draft on a date (YYYY-MM-DD, tenant timezone) at scheduled_time ('HH:mm', tenant timezone) or, with none, at the tenant's publish time; update patches an existing one (date, and with the date its scheduled_time, caption, post type, approval mode, slides, recurrence); remove cancels it (soft-delete); bulk_fill generates AI drafts for each empty day in the next N days (up to a month, 31, in one call), one a day or two with per_day=2 (a morning and an evening post, at times), drawn by Pith when the account is on AI pictures and over the account's own photos otherwise; it creates only the posts the plan's stories cap will publish and answers with left_out (count, dates, the plan's numbers) for the ones that did not fit, which were not created: tell the owner; mute_day / unmute_day mutes or unmutes one date (pass date, YYYY-MM-DD in the tenant's timezone): on a muted day Pith drafts nothing and posts nothing, and a post already scheduled on it is held (not moved, not cancelled) until the day is unmuted. Today and up to a year ahead may be muted; any day may be unmuted. Mute a day only when the owner asked for it. Carousels need 2-10 slides. A draft created with a date posts at that date's publish time (approval_mode=scheduled, the default when none is given); pass approval_mode=email to have it wait for the owner's explicit publish_draft call or tap instead, approval_mode=auto to publish it at that time, or approval_mode=warning to publish it at that time after emailing the owner a cancel link about 24h before. Set auto or warning only when the owner asked for it: choosing one is their approval of that post. Scheduling is refused with scheduling_not_available where timed publishing is not enabled for the account. add/update answer with warnings when the post will not go out at its time: beyond the plan's stories cap (scheduled posts count as stories, even with the owner's own photo), vacation mode on for the account, or the post left in approve-first mode (waits_for_tap: it waits for the owner's tap); tell the owner.

Inputs: action (required), context (required), date, days, +15 more.

generate_draftGenerate today's draftsA
DestructiveIdempotent
Inspect

Run the daily draft engine now: generates today's pending drafts for the active flow (calendar-aware, freshness-guarded, validator-checked). Idempotent per day: re-running fills gaps without touching drafts the user already decided on. force=true wipes today's PENDING drafts first. slot_index targets ONE slot of a configured asset flow (campaign/daily-products/daily-generative) so a single failed slot can be re-fired without regenerating the day. SLOW: each draft is 1-3 LLM calls.

Inputs: context (required), force, handle, beat_slug, +1 more.

get_billing_statusGet billing statusA
Read-only
Inspect

Subscription state for the account: active/cancelled/none, the plan, and whether a payment method is on file. Free is a real product state: 'none' does not mean broken.

Inputs: context (required), handle.

get_brand_dnaGet brand DNAA
Read-only
Inspect

The tenant's Brand DNA (identity, voice, palette, and posting beats): the single source of truth every draft is generated from. Includes any pending drift proposal (a background-detected update awaiting the owner's yes/no).

Inputs: context (required), handle.

get_checkout_urlGet an upgrade checkout linkAInspect

Create a hosted checkout session for a plan upgrade and return its URL for the user to open, with the plan's price and what it changes. Call once per upgrade and show the owner that link. NEVER charges on its own: payment happens only if the user completes the hosted checkout themselves.

Inputs: context (required), plan, handle, interval.

get_draftGet draftA
Read-only
Inspect

Fetch one draft in full detail. Set include_image_url=true to also render (or fetch the cached render of) the story image. NOTE: a cold render calls the image model and can take 60-90 seconds.

Inputs: context (required), draft_id (required), handle, include_image_url.

get_flowGet the active flowA
Read-only
Inspect

The tenant's daily content loop: which of the five flows is active (recycle-1d, recycle-nd, campaign, daily-products, daily-generative), its config, readiness, and how/when it was decided. Includes the full flow catalog for reference.

Inputs: context (required), handle.

get_scheduleGet the publish scheduleA
Read-only
Inspect

List every draft with a scheduled publish time (soonest first), excluding rejected ones. Times are UTC instants; the tenant's timezone is included for display. Each item's capVerdict says whether it will publish at its time under the plan's stories cap, scheduledPublishFailedReason why a past one did not (a post the plan held also carries scheduledPublishFailedMessage: whether it will still go out by itself, and what not to do), and waitingForTap marks a post past its time that waits for the owner's go-ahead, and notices names account-level blockers (stories cap, vacation mode, posts waiting for a tap). mutedDays lists the dates (YYYY-MM-DD, tenant timezone) the owner muted on /schedule: nothing is drafted or posted on them, and an item with heldByMutedDay true will not go out unless the owner unmutes its day.

Inputs: context (required), handle.

get_tenantGet account profileA
Read-only
Inspect

Fetch a tenant's profile: brand DNA (voice, palette, beats), active flow + config, Instagram connection state, automation settings, and timezone. Use include_drafts/include_scraped_images only when you need them; both can be large.

Inputs: context (required), handle, include_drafts, include_scraped_images.

get_usageGet plan usageA
Read-only
Inspect

Plan tier plus metered usage: AI stories used in the rolling 30-day window (published OR downloaded), when the next slot frees up, the monthly reels budget, byo (publish-your-own-content) publishes in the trailing 24h, and the current publish streak. Bring-your-own-content posts (publish_post) never count against the stories meter. resetAt is authoritative; never assume calendar months.

Inputs: context (required), handle.

list_assetsList photosA
Read-only
Inspect

The tenant's pickable images: recent uploads plus the scraped Instagram portfolio (ids like scraped:3). Use asset ids with manage_product, edit_schedule, set_flow campaign_asset_ids, or delete_asset (uploads only). Raise limit (≤100) when auditing a large campaign pool: the default 12 shows only the freshest uploads. Each photo carries use ({count, lastAt} of the posts that showed it, or null when none has) and reuseAllowed: Pith posts every photo once and picks unused ones first, unless the owner allowed it to come back.

Inputs: context (required), limit, handle.

list_draftsList draftsA
Read-only
Inspect

List story/post drafts for an account, newest first. Filter by status (pending = awaiting your approve/reject). verbosity=summary returns the fields needed to decide; full adds every column except secrets.

Inputs: context (required), limit, handle, status, +1 more.

list_eventsRead the activity logA
Read-only
Inspect

The tenant's event-log tail, newest first: the source of truth for WHY something did or didn't happen (PUB-13/OPS-6): calendar blocks and reshapes (calendar_block/calendar_reshape), freshness flags (freshness_flag), publish attempts and outcomes, scrape/token refreshes. Use this when generate_draft came back empty or a scheduled publish didn't land. Optional exact event filter; limit ≤ 200.

Inputs: context (required), event, limit, handle.

list_productsList productsC
Read-only
Inspect

Active products with their attached photos: the pool the daily-products flow draws from.

Inputs: context (required), handle.

manage_productCreate / rename / archive a product, attach photosA
Destructive
Inspect

Product CRUD for the daily-products flow. action=create (name required), rename (product_id + name), archive (product_id; soft delete, also drops it from the flow pool), add_photo (product_id + asset_id from list_assets), remove_photo (asset_id), set_description (product_id + description; empty string clears), set_price (product_id + price in major units, e.g. 82 for ₪82; optional currency, default ILS; price -1 clears), set_markings (product_id + carries_own_markings: true when the product itself carries print that is part of it, such as a printed name, patches or a logo it is sold with, so restaged pictures keep it exactly instead of redrawing it; false clears). Owner-set prices are display-grade: they may appear on rendered stories (FLOW-14).

Inputs: action (required), context (required), name, price, +6 more.

onboard_tenantOnboard an Instagram handleA
DestructiveIdempotent
Inspect

Create and link a NEW pith.day account from a public Instagram handle: scrape the profile, derive Brand DNA, classify the best daily flow, and seed today's first drafts. This is the ONLY tool that links a tenant to your user (MCP-17); a handle already owned by another pith.day account is refused, never claimed. SLOW (~60-120s: scrape + OCR + DNA + classify). If the call times out client-side, simply call it again: a completed onboarding returns immediately, and a fresh scrape is cached for 24h. After it returns: curate the photo pool with get_tenant {include_scraped_images} + curate_images (off-brand photos produce weird stories), then get_flow / set_flow.

Inputs: handle (required), context (required), force.

propose_briefWhat Pith would post for this accountA
Read-only
Inspect

Pith's homework before the owner says what they want: 4–6 directions for the daily posts, from the account's own Instagram, website and Brand DNA, each with one line on what Pith would make. Show them to the owner as choices and let them pick (several is fine), then call set_brief with the labels they chose plus anything they said in their own words. An option with kind "needs-photos" needs the business's own people (the owner, the team, real regulars) or its product worn: Pith may draw a hand or a child, never someone in particular, so present it as "send photos of this and the stories use those", never as a promise. Also returns the brief currently on file, if any, and whether it is due for a review (a month old).

Inputs: context (required), handle.

publish_draftPublish a draft to InstagramA
Destructive
Inspect

Publish ONE approved (or edited) draft to Instagram right now, through the full pipeline: payment gate, monthly AI-story cap, publish lease (never double-posts against the cron), retry with backoff. The draft must already be approved: use update_draft first. A scheduled draft is refused (the scheduler owns it, unschedule first).

Inputs: context (required), draft_id (required), handle.

publish_postPublish your own post to InstagramA
Destructive
Inspect

Publish the user's own image(s) + caption to their connected Instagram account RIGHT NOW: story, feed post, or 2-10 image carousel. On the Free plan each post counts toward the plan's monthly posts (5 per rolling 30 days, shared with AI stories and scheduled posts); on Pro these posts don't count toward it. A light daily anti-abuse bound applies on every plan. On the Free plan a short '✨ Posted with pith.day' line is appended to feed/carousel captions (the response's finalCaption shows exactly what was posted; Pro removes it). Stories publish the image as-is and Instagram ignores story captions. Requires a connected account (connect_instagram). Timeouts are safe: pass a random idempotency_key on the first call, and if the call times out, call again with the same key OR the returned draft_id; nothing double-posts. Scheduling is not supported here: posts go out immediately.

Inputs: context (required), handle, slides, caption, +5 more.

refine_brand_dnaRefine brand DNA via chatA
Destructive
Inspect

The chat-tuned Brand DNA editor: describe a change in plain language ('warmer voice', 'add a Friday specials beat', 'switch palette to sage green') and the LLM produces a schema-validated patch. preview_only=true returns the patched DNA without saving; otherwise the change is persisted immediately.

Inputs: context (required), message (required), handle, preview_only.

refresh_scrapePull new Instagram photosAInspect

Read the Instagram grid again and ADD the photos Pith does not hold yet ('I posted new things, pull them in'). Nothing is replaced: photos already held keep their place, and Brand DNA, flow, products and drafts are untouched. New photos are read for products. Takes ~30-90s.

Inputs: context (required), handle.

refresh_websiteRead the business websiteA
Idempotent
Inspect

Crawl the tenant's website and run the enrichment pipeline: conservative Brand-DNA facts (never voice), product import via the catalog adapters, and site-image review candidates. Re-crawls are cached for 24h: a repeat call inside the window returns status:"cached" without spending a crawl. Long sites keep processing server-side even if this call times out; results persist per product, so just call again.

Inputs: context (required), handle.

regenerate_brand_dnaRe-derive brand DNA from InstagramA
Destructive
Inspect

Re-scrape the tenant's Instagram and re-derive Brand DNA from scratch. SLOW (60s+) and it REPLACES the current DNA, so confirm with the user before calling. Prefer refine_brand_dna for adjustments.

Inputs: context (required), handle.

regenerate_draftRegenerate a draft's textA
Destructive
Inspect

Re-draft one draft's story text (optionally steering with an angle), resetting it to pending and invalidating its cached render. Capped per tier: Free 1/day per draft, Pro 5/day.

Inputs: context (required), draft_id (required), angle, handle.

set_automationUpdate automation settingsA
Idempotent
Inspect

Tenant automation settings: daily-email recipient, timezone, the daily loop on/off switch (daily drafts + the approval email; it does not stop scheduled posts), schedule_paused (vacation mode: true holds every scheduled post until set back to false; only when the owner asks), default publish time (HH:mm), WhatsApp approval pings, and (Pro only) hiding the '✨ Posted with pith.day' caption tag. Only fields you pass are changed; pass null to clear a nullable field. notification_email must be an address the user gave you, never one you guessed or looked up; for an Instagram-first account it also becomes their sign-in email.

Inputs: context (required), handle, timezone, schedule_paused, +6 more.

set_briefRecord what the owner wants from PithA
DestructiveIdempotent
Inspect

Record the owner's brief (what they want their daily posts to be about) on the Brand DNA. wants: up to 6 short directions in their words or the labels they picked from propose_brief; avoid: up to 6 things they never want to see; note: their own words (up to 400 characters). Arrays replace what was there. The brief WEIGHS what tomorrow's drafts are about across the week; it never makes every post about one thing. Pass keep=true to confirm the brief on file unchanged (the monthly review), or forget=true to remove it. Ask the owner; never invent a brief.

Inputs: context (required), keep, note, avoid, +3 more.

set_day_noteTell Pith what is happening todayA
DestructiveIdempotent
Inspect

Give Pith one line, in the owner's own words, about what is true today or tomorrow: a new item, a sold-out loaf, hours, a guest, an event, a mood with a subject. Every story draft written in the next 36 hours (the morning batch, regenerates) is written about it, in the brand's voice. Replaces the previous note; pass note: "" to clear. Ask the owner, never invent the fact.

Inputs: note (required), context (required), handle.

set_flowSwitch flow / update flow configA
Destructive
Inspect

Switch the tenant's daily flow and/or patch its configuration. Switching flows reseeds a starter config and clears TODAY'S pending drafts (approved/published drafts are preserved) so the inbox reflects the new flow. Config fields are per-flow: recycle → source_post_indices + slots_per_day (1-4); daily-products → product_pool_ids; daily-generative → reference_image_urls (≤10) + brand_prompt (≤2000 chars); campaign → campaign_name (≤80) /start/end dates (YYYY-MM-DD, end ≥ start) + campaign_asset_ids (≤60, must exist) + campaign_posts_per_day (1-3). post_mix is the OWNER's call and applies to every flow: 'stories' (the default for an owner who has never been asked), 'both' (a story daily plus a feed post on the feed_days rhythm) or 'feed' (grid only: every draft is a post). Never set it on your own initiative: ask the user which they want. It survives a flow switch. feed_days is read only under 'both': tenant-local weekdays (0=Sun..6=Sat) that draft a FEED POST next to the day's story (unset = the flow's suggested rhythm: daily-products Mon+Thu, daily-generative Tue, recycle Mon; [] = no feed day). Campaign derives its feed days from the range (first + last day) instead.

Inputs: context (required), flow, config, handle.

set_running_offerTell Pith about a sale or launch that is runningA
DestructiveIdempotent
Inspect

Record the offer the owner has running now (a sale, a launch, a holiday deal) in their own words, with the last day it runs (YYYY-MM-DD, the account's timezone). Every story draft written until then may carry it, and none ever mentions an offer the owner did not give here. Replaces the previous one; pass text: "" to remove it. Ask the owner for the terms and the end date, never invent or guess them.

Inputs: text (required), context (required), endsOn, handle.

set_websiteSet the business websiteA
DestructiveIdempotent
Inspect

Set (or clear) the tenant's business website URL. Bare domains are accepted (yourshop.com → https://yourshop.com). Setting a new URL clears the previous crawl state; call refresh_website afterwards to read the site (Brand-DNA enrichment + product import + image review candidates). Pass website: "" to clear.

Inputs: context (required), website (required), handle.

update_draftApprove / reject / edit / schedule a draftA
Destructive
Inspect

The approval-inbox verb. action=approve (optionally with schedule_at 'HH:mm' in the account's timezone), reject, edit (requires overlay_lines and/or overlay_spec; implies approval), unschedule (clears a pending schedule), or convert_to_reel (Pro plan). Terminal drafts (published/rejected/failed) cannot be changed. When the user rewrites a draft's words, ask the user whether the change is for this draft only or for every draft from now on, and pass their answer as teach ('this_draft' or 'from_now_on'); never guess it. 'from_now_on' teaches the brand at once and the result says what was learned (learned, lesson.diff); tell the user exactly that.

Inputs: action (required), context (required), draft_id (required), teach, +6 more.

whoamiWho am IA
Read-only
Inspect

Identify the connected pith.day user: email, linked Instagram accounts (with connection + publish capability per account), plan tier per account, and the scopes this connection was granted. Call this first to discover the handle other tools need. No accounts yet? Use connect_instagram to link one. Each onboarded account carries capabilities: whether Pith draws new pictures itself and whether that is on (set_flow), the website it reads (set_website), that an approved post can go out by itself at a set time in the account's timezone (edit_schedule), that the owner's own images are accepted (add_asset), and how many posts a month and drafts a morning each plan covers. Read it before telling the user something is not possible, and answer capability and plan questions from it.

Inputs: context (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Remote MCP server that lets AI assistants read tracked competitive intelligence — competitor news, reviews, website changes, social posts and ads — and act on it by managing projects, competitors, battle cards, reports and canvases. Every answer carries a source and a date, and write actions only publish when explicitly shared.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables brand visibility monitoring across major AI platforms like ChatGPT, Claude, Gemini, and Perplexity. It allows users to track visibility scores, analyze competitor data, and receive actionable insights to improve AI-generated brand recommendations.
      16
      11 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Browse IndustryLens's published competitive-intelligence reports and head-to-head competitor comparisons from any AI agent — real, source-backed data.
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources