Shipfolio

Shipfolio is where indie founders list their products with their tech stack, launches and Stripe-verified revenue. Connect it to Claude, Cursor or VS Code to research products, stacks, tool alternatives and pricing, or to update your own listing, stack, FAQs, screenshots and launch date. Sign in with OAuth; the free plan works.

Hosted MCP Server

npx add-mcp 'https://api.shipfolio.io/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

What you can do

The server speaks for you: anything you can see or change on Shipfolio, your assistant can too, within the access you approve.

Run your listing from chat

Research the market

Connect your client

Add the server once with its URL. The first time a tool runs, your client opens Shipfolio in the browser so you can sign in and approve it.

Claude

On claude.ai. Connectors you add there also work in the desktop and mobile apps.

  1. 1 Open connector settings Settings Connectors Add custom connector Open Claude
  2. 2 Name it Shipfolio and paste the URL Copy
  3. 3 Select Connect, then sign in to Shipfolio Approve the access you want on the page that opens. Claude keeps it until you disconnect.

Claude Code

Add it from your terminal, then run /mcp in Claude Code and pick shipfolio to sign in.

Terminal Copy

claude mcp add --transport http shipfolio https://api.shipfolio.io/mcp

Add --scope user to use it in every project, not just this one.

Cursor

Install it in one click, or add it to your config by hand. Cursor asks you to sign in when it connects.

Add to Cursor

~/.cursor/mcp.json Copy

{
  "mcpServers": {
    "shipfolio": {
      "url": "https://api.shipfolio.io/mcp"
    }
  }
}

VS Code

With GitHub Copilot's agent mode. Add it for your user from a terminal, or for one workspace in its config.

Terminal Copy

code --add-mcp '{"name":"shipfolio","type":"http","url":"https://api.shipfolio.io/mcp"}'

.vscode/mcp.json Copy

{
  "servers": {
    "shipfolio": {
      "type": "http",
      "url": "https://api.shipfolio.io/mcp"
    }
  }
}

Other clients and API keys

Any client that supports Streamable HTTP and OAuth with dynamic client registration connects with just the URL. For one that can't sign in, like a script or a CI job, send a personal API key as a Bearer token instead.

Header Copy

Authorization: Bearer sfk_…

mcp.json Copy

{
  "mcpServers": {
    "shipfolio": {
      "url": "https://api.shipfolio.io/mcp",
      "headers": {
        "Authorization": "Bearer sfk_…"
      }
    }
  }
}

API keys are part of Company Pro and are made in Settings, API keys. A key only reads unless you tick "Can make changes" when you create it.

Signing in

Shipfolio uses OAuth, so your client never sees your password. Any Shipfolio account can connect, including the free plan.

  1. 1 Your client opens Shipfolio in your browser Sign in as you normally do, with Google, GitHub or your email.
  2. 2 Check who is asking The consent screen shows the app, the address it will send you back to, and the access it wants. Apps register themselves, so connect only ones you started from your own client.
  3. 3 Choose the access Read is always included. Tick "Make changes" only if you want the app to edit your listings.
  4. 4 Approve The app gets a token that lasts 1 hour and renews itself while you keep using it. After 30 days without use, you sign in again.
ScopeLets the app
read Always- Search public products, stacks, tools, launches and articles - Read your listings, including private ones, and their analytics
write Optional- Edit your listings: tagline, features, FAQs and stack - Post ship log entries and schedule launches

If an app with read access tries to make a change, your client asks you to approve again with "Make changes" ticked. Nothing is changed until you do.

Disconnect an app any time under Settings, Connected apps. It stops working on its next call.

Example prompts

Paste one into your assistant once it's connected. Replace the parts in brackets.

  • What is [product] built with, and what would it cost me to run the same stack? get_product_stackget_tool Copy
  • Find verified-revenue products in the devtools niche using Supabase. search_products Copy
  • Compare the stacks of [product] and [product]. Where do they differ? compare_stacks Copy
  • Plan my launch for next Tuesday and draft three ship log entries. schedule_launchpost_ship_log_entry Copy
  • Update my tagline to "Time tracking that fills in your timesheet for you". update_my_listing Copy
  • Which products are climbing the Making Money board this month, and what do they run on? making_moneyget_product_stack Copy

Tool reference

50 tools, read from the server (version 1.0.0). Your client lists the same set.

Look up one thing 11

One product, stack, tool, profile or comparison. Counted as lookups.

list_niches

Read

List niches Read-only

The curated niche list: the only niches update_my_listing, create_article_draft and update_article_draft accept. Search by name or synonym ("fintech" finds Finance); without a query, every niche A to Z, 50 at most. Pass the slug to write tools. A niche that isn't on the list can only be proposed by the person, in the editor.

query string Optional

Words to look for, e.g. "time tracking"; leave out for the whole list Up to 60 characters

get_founder

Read

Founder profile Read-only

A person's public Shipfolio profile: headline, bio, their products, work history and recent ship log. Contact details are never included; to reach someone, link them to their profile.

handle string Required

The handle, as in shipfolio.io/@{handle} Up to 40 characters

get_company

Read

Company profile Read-only

A company's public page: about, website, its public products and, when the company shows it, its team.

slug string Required

The company's slug, as in shipfolio.io/companies/{slug} Up to 100 characters

get_product_timeline

Read

Get a product's timeline Read-only

A public product's verified timeline, newest first, 20 events a page: releases from its changelog, verified MRR milestones and month-over-month changes, stack changes (a migration reads "Switched from X to Y" with the founder's reason), launches, articles, infrastructure cost when the founder shares it, and weekly updates. Each event says who verified it (Stripe, RevenueCat, AppStore, GooglePlay, GitHub, Shipfolio or Founder): say so when citing a figure. Money is in cents. Traffic is never on it.

slug string Required

The product's slug, e.g. "trackwise" (search_products finds it) Up to 100 characters

page integer Optional

The page, from 1 1 to 5 Default 1

get_product

Read

Get a product Read-only

One public product page: what it does, pricing, niches, its stack, launch, recent ship log, verified MRR exactly as the page shows it, features, FAQs, the products it is an alternative to, and similar products. When the founder shares both, margin is last full month's verified MRR against its cloud bill (rounded, with the providers), so absent means not shared, never zero. Each distinct product you open counts toward a daily limit, so open the ones the user cares about rather than every search result.

slug string Required

The product's slug, the last part of shipfolio.io/p/{slug} Up to 100 characters

get_product_stack

Read

What is it built with Read-only

What a product is built with: every tool in its stack by category, the founder's notes and monthly costs where shared, and the stack analysis (summary, failure points, optimizations) when there is one.

slug string Required

The product's slug Up to 100 characters

compare_stacks

Read

Compare two stacks Read-only

Two products' stacks side by side: the tools they share and the ones only each uses, with a link to the comparison page.

a string Required

First product's slug Up to 100 characters

b string Required

Second product's slug Up to 100 characters

get_stack_report

Read

Get the stack report Read-only

Shipfolio's monthly State of indie stacks report: the most used tools overall and by category with their change against the previous month, fastest rising tools, common tool pairs, hosting platform share, cloud cost quartiles by provider and MRR band, tool use among products with verified MRR (median MRR band, never figures), pricing model mix and the month's launches. Anonymous aggregates: every figure counts at least five products, and no product is named. Cite the report's url. Without month, the latest published one.

month string Optional

The month, yyyy-MM (e.g. "2026-10"); leave out for the latest Up to 7 characters

get_tool

Read

Get a tool Read-only

A tool in Shipfolio's catalog (Stripe, Supabase, Astro…): what it is, pricing note, how many products use it, the top 10 products built with it, tools it's often used with, and alternatives. For more products built with it, call search_products with tool.

slug string Required

The tool's slug, e.g. "supabase" (search_tools finds it) Up to 80 characters

get_tool_migrations

Read

Get a tool's migrations and adoption Read-only

Which tools public Shipfolio products replaced with this one (movingTo) and replaced it with (movingFrom), each with how many products made the move and its page, and the tool's adoption over the last twelve months (products using it at each month's end, products adding and removing it, net change). Only moves made by at least five products are listed, and any monthly figure under five is null: say "fewer than five" rather than guessing. Products are never named here; cite the urls.

slug string Required

The tool's slug, e.g. "heroku" (search_tools finds it) Up to 80 characters

get_tool_pricing

Read

Get a tool's pricing Read-only

A catalog tool's plans as Shipfolio last recorded them from its pricing page (name, monthly and yearly price in cents, unit for per-unit pricing, key limits, free tier, source and the date checked), and its published price changes, newest first, each with what changed. Plans are null until Shipfolio has approved a first reading. productCount is how many public products use the tool, shown only from five. Cite the url; prices can change after the date checked.

slug string Required

The tool's slug, e.g. "vercel" (search_tools finds it) Up to 80 characters

Your account 7

Your own listings and analytics. Counted as account reads.

list_my_articles

Read

My articles Read-only

The signed-in person's articles across their products, drafts and published, newest first, each with its editor link.

No parameters.

list_embed_sources

Read

What a draft can embed Read-only

For one of the signed-in person's draft articles: the products it can chart (the article's own product first) and, per metric (MRR, cloud cost, cloud cost by provider, visitors, page views, website clicks, launch votes), whether there is data, where it comes from, the days it covers and, when missing, why. Call this before add_article_embed.

articleId string (uuid) Required

The draft article's id

get_my_analytics

Read

My analytics Read-only

Page views, visitors, website clicks, impressions, upvotes, new watchers and reviews for the last 7, 30 or 90 days against the period before: for one of the signed-in person's products (with top sources and referrers), or all of them. Analytics unlock with Company Pro or a connected Stripe account; locked products come back without numbers.

listing string Optional

The listing's slug or id; all products when left out Up to 100 characters

days integer Optional

7, 30 or 90 One of 7 30 90 Default 30

list_my_listings

Read

My listings Read-only

The signed-in person's own products (every product of a company they own or admin), drafts and private ones included: status, completeness, stack size, verified MRR, launch, and links to the public page and the editor.

No parameters.

get_my_listing

Read

My listing Read-only

One of the signed-in person's own products in full: every editable field, completeness gaps (what each empty field would rank for), stack, features (has, doesn't have, suggested from alternatives), FAQs with their ids, launch, verified MRR, and margin: last full month's MRR against cloud cost, exact and private to the team, plus what the public page shows and what keeps it off. Sharing the cost publicly is the founder's own choice on the costs page; never suggest it is done for them.

listing string Required

The listing's slug or id, from list_my_listings Up to 100 characters

list_my_screenshots

Read

My product's screenshots Read-only

The screenshot gallery of one of the signed-in person's own products, in the order it shows: each screenshot's id, public addresses, size, alt text, caption and device frame. Call this before remove_listing_screenshot.

listing string Required

The listing's slug or id, from list_my_listings Up to 100 characters

list_my_updates

Read

My weekly updates Read-only

The weekly build in public updates of the products the signed-in person manages, newest week first: drafts waiting, published and skipped ones, each with its editor link and, once published, its public page.

No parameters.

Make changes 20

Edit your listings. Needs the write scope; counted as writes.

create_article_draft

Needs write

Draft an article Not destructiveNot idempotent

Drafts an article about one of the signed-in person's products: what they built, learned or launched. The body is Markdown (headings, lists, tables, links, code; no raw HTML). Calling twice makes two drafts. To show a product's tech stack, draft the text and then call add_stack_embed rather than typing a table of tools: the card stays current and links each tool. The article is saved as a draft only: nothing is published. The author reviews it, adds a cover image or data embeds and publishes it in the Shipfolio editor at editUrl. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id the article is about Up to 100 characters

title string Required

The headline, at most 120 characters Up to 120 characters

body string Required

The article in Markdown, at most 40,000 characters Up to 40000 characters

subtitle string Optional

A one-line standfirst under the headline, at most 240 characters Up to 240 characters

nicheTags array of string Optional

Up to 3 niche slugs from list_niches, e.g. ["invoicing"] Up to 3 items

update_article_draft

Needs write

Edit an article draft DestructiveSafe to repeat

Changes a draft article of the signed-in person's: only the fields given, the rest stay. Published articles can't be changed here. A new body replaces the whole body. The article is saved as a draft only: nothing is published. The author reviews it, adds a cover image or data embeds and publishes it in the Shipfolio editor at editUrl. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

articleId string (uuid) Required

The article's id, from create_article_draft or list_my_articles

title string Optional

A new headline, at most 120 characters Up to 120 characters

body string Optional

The whole new body in Markdown, at most 40,000 characters Up to 40000 characters

subtitle string Optional

A new standfirst, at most 240 characters Up to 240 characters

nicheTags array of string Optional

Replaces the niches: up to 3 slugs from list_niches Up to 3 items

add_article_embed

Needs write

Add a data embed to a draft Not destructiveNot idempotent

Adds a live data embed (a line or bar chart, a period comparison, or headline stats) to one of the signed-in person's draft articles, from their own verified data, and places it in the body after the heading given (or at the end). Returns the figures it shows: quote those exactly in the text around it instead of guessing. Money values are in cents. A draft holds at most 6 embeds. Snapshot (the default) freezes the figures when the article is published; live keeps them current. The article is saved as a draft only: nothing is published. The author reviews it, adds a cover image or data embeds and publishes it in the Shipfolio editor at editUrl. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

articleId string (uuid) Required

The draft article's id

product string Required

The product to chart: a slug from list_embed_sources Up to 100 characters

kind string Required

Line, Bars, Comparison (first period against the last) or Stat (one headline figure per metric) One of Line Bars Comparison Stat

metrics array of object Required

1 to 4 metrics, e.g. [{"metric":"Mrr"}] or [{"metric":"CloudCostByProvider","provider":"GoogleCloud"}] 1 to 4 items

range string Optional

The range: Last2Weeks, Last4Weeks, Last8Weeks, Last12Weeks, Last3Months, Last6Months, Last12Months, LaunchWeek or Custom One of Custom Last2Weeks Last4Weeks Last8Weeks Last12Weeks Last3Months Last6Months Last12Months LaunchWeek Default Last3Months

granularity string Optional

Day, Week or Month buckets One of Day Week Month Default Week

from string (date) Optional

With Custom: the first day, yyyy-MM-dd

to string (date) Optional

With Custom: the last day, yyyy-MM-dd

caption string Optional

A caption under the embed, at most 200 characters Up to 200 characters

afterHeading string Optional

Place it after the heading with this text, e.g. "What it costs to run"; at the end when left out or not found Up to 200 characters

live boolean Optional

true keeps the figures current after publishing; false (default) freezes them when published Default false

remove_article_embed

Needs write

Remove a data embed from a draft DestructiveSafe to repeat

Deletes a data embed from one of the signed-in person's draft articles and takes its line out of the body. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

articleId string (uuid) Required

The draft article's id

embedId string (uuid) Required

The embed's id, from add_article_embed

add_stack_embed

Needs write

Add a stack card to a draft Not destructiveNot idempotent

Places a card of a product's tech stack (its tools grouped by category, each linking to the tool's Shipfolio page) in one of the signed-in person's draft articles, after the heading given (or at the end). Any product with a public Shipfolio page works, not only the person's own. Returns exactly the tools the card shows: write about those, not a stack you assume. Prefer this to typing a table of tools. The card is read live from public pages for every reader, so it stays current; if the product later stops being public, readers see a placeholder instead. A draft shows up to 12 cards. The article is saved as a draft only: nothing is published. The author reviews it, adds a cover image or data embeds and publishes it in the Shipfolio editor at editUrl. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

articleId string (uuid) Required

The draft article's id

product string Required

The product's slug, e.g. "trackwise" (search_products finds it) Up to 100 characters

afterHeading string Optional

Place it after the heading with this text, e.g. "What we built it with"; at the end when left out or not found Up to 200 characters

add_product_embed

Needs write

Add a product card to a draft Not destructiveNot idempotent

Places a card of a product (logo, name, tagline, its verified MRR badge when it has one, and a link to its Shipfolio page) in one of the signed-in person's draft articles, after the heading given (or at the end). Any product with a public Shipfolio page works, not only the person's own. Returns what the card shows. The card is read live from public pages for every reader, so it stays current; if the product later stops being public, readers see a placeholder instead. A draft shows up to 12 cards. The article is saved as a draft only: nothing is published. The author reviews it, adds a cover image or data embeds and publishes it in the Shipfolio editor at editUrl. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

articleId string (uuid) Required

The draft article's id

product string Required

The product's slug, e.g. "trackwise" (search_products finds it) Up to 100 characters

afterHeading string Optional

Place it after the heading with this text; at the end when left out or not found Up to 200 characters

add_tool_embed

Needs write

Add a tool card to a draft Not destructiveNot idempotent

Places a card of a tool from Shipfolio's catalog (logo, name, category, a short description, how many products use it, and a link to its page) in one of the signed-in person's draft articles, after the heading given (or at the end). Returns what the card shows. The card is read live from public pages for every reader, so it stays current; if the product later stops being public, readers see a placeholder instead. A draft shows up to 12 cards. The article is saved as a draft only: nothing is published. The author reviews it, adds a cover image or data embeds and publishes it in the Shipfolio editor at editUrl. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

articleId string (uuid) Required

The draft article's id

tool string Required

The tool's slug, e.g. "supabase" (search_tools finds it) Up to 80 characters

afterHeading string Optional

Place it after the heading with this text; at the end when left out or not found Up to 200 characters

post_ship_log_entry

Needs write

Post to my ship log Not destructiveNot idempotent

Posts "shipped X" to the public changelog of the signed-in person's product. Calling twice posts twice; followers can see it. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

title string Required

What shipped, at most 140 characters Up to 140 characters

body string Optional

Details, at most 4000 characters Up to 4000 characters

shippedOn string (date) Optional

The day it shipped, yyyy-MM-dd; today when left out

schedule_launch

Needs write

Schedule my launch DestructiveSafe to repeat

Schedules the signed-in person's product on Shipfolio's launch board for a UTC day, or moves its scheduled launch there. The listing must be published with at least 3 tools in its stack, and the day can't be in the past. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

launchDate string (date) Required

The launch day, yyyy-MM-dd (UTC)

update_my_listing

Needs write

Update my listing DestructiveSafe to repeat

Changes fields of one of the signed-in person's own products: tagline, description (markdown), problem statement, niches, audience tags and the products it is an alternative to. Only the fields given change; a list replaces the old list. Overwrites what is there. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

tagline string Optional

New tagline, at most 80 characters Up to 80 characters

description string Optional

New description, markdown Up to 10000 characters

problemStatement string Optional

The problem it solves, one or two sentences Up to 500 characters

niches array of string Optional

Niche slugs from list_niches; replaces the current ones. Unknown ones are refused with the closest valid slugs Up to 10 items

audience array of string Optional

Audience tags; replaces the current ones Up to 10 items

alternativeTo array of string Optional

Products it is an alternative to, by name; replaces the current ones Up to 10 items

add_my_feature

Needs write

Add a feature Not destructiveSafe to repeat

Adds a feature the signed-in person's product has ("Two-factor authentication"). Shipfolio matches it to the shared feature list so comparisons line up. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

name string Required

The feature's name Up to 80 characters

set_my_feature

Needs write

Answer a feature DestructiveSafe to repeat

Says whether the signed-in person's product has a feature already on its list or suggested from its alternatives: true, false, or null to take the answer back. Replaces the current answer. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

feature string Required

The feature's slug or name, from get_my_listing Up to 80 characters

has boolean Optional

true: has it; false: doesn't; null: unanswered

add_my_faq

Needs write

Add an FAQ Not destructiveNot idempotent

Adds a question and answer to the FAQ on the signed-in person's product page (5 at most, 20 with Company Pro). Calling twice adds it twice. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

question string Required

The question, at most 200 characters Up to 200 characters

answer string Required

The answer, at most 1500 characters Up to 1500 characters

update_my_faq

Needs write

Edit an FAQ DestructiveSafe to repeat

Rewrites one FAQ on the signed-in person's product, replacing its question and answer. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

faqId string (uuid) Required

The FAQ's id, from get_my_listing

question string Required

The question, at most 200 characters Up to 200 characters

answer string Required

The answer, at most 1500 characters Up to 1500 characters

remove_my_faq

Needs write

Remove an FAQ DestructiveSafe to repeat

Deletes one FAQ from the signed-in person's product page. It can't be undone. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

faqId string (uuid) Required

The FAQ's id, from get_my_listing

remove_listing_screenshot

Needs write

Remove a screenshot from my product DestructiveSafe to repeat

Deletes one screenshot from one of the signed-in person's product galleries; the others keep their order. Returns the gallery as it is afterwards. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

screenshotId string (uuid) Required

The screenshot's id, from list_my_screenshots or add_listing_screenshot

add_to_my_stack

Needs write

Add a tool to my stack Not destructiveNot idempotent

Adds a catalog tool to the stack of the signed-in person's product, with an optional note and monthly cost. A launch needs at least 3 tools. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

tool string Required

The tool's slug (search_tools finds it) Up to 80 characters

category string Optional

Category; the tool's own when left out One of Frontend Backend Database Auth Payments Hosting Email Analytics Monitoring AI Storage Search CMS DevTools Marketing Support Other

note string Optional

What it's used for, at most 280 characters Up to 280 characters

monthlyCostUsd integer Optional

Monthly cost in whole US dollars 0 to 1000000

update_my_stack_item

Needs write

Edit a stack tool DestructiveSafe to repeat

Changes the category, note or monthly cost of a tool already in the signed-in person's stack; fields left out stay. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

tool string Required

The tool's slug or name Up to 80 characters

category string Optional

New category One of Frontend Backend Database Auth Payments Hosting Email Analytics Monitoring AI Storage Search CMS DevTools Marketing Support Other

note string Optional

New note, at most 280 characters Up to 280 characters

monthlyCostUsd integer Optional

New monthly cost in whole US dollars 0 to 1000000

remove_from_my_stack

Needs write

Remove a stack tool DestructiveSafe to repeat

Removes a tool from the signed-in person's stack, with its note and cost. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

tool string Required

The tool's slug or name Up to 80 characters

draft_product_update

Needs write

Draft a weekly update Not destructiveNot idempotent

Drafts the build in public update of one of the signed-in person's products for a week that has ended (last week by default), from that week's verified signals, or rewrites a waiting draft. Returns the week's facts with their exact figures: any title or body given must quote only those figures, exactly as written, or it is refused. Traffic and an unshared cloud cost come back as private notes and must not go in the text. Nothing is published: the founder reviews, shares and publishes it at editUrl. A published or skipped week can't be changed here. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

week string Optional

The ISO week as yyyy-ww, e.g. "2026-46"; last week when left out Up to 7 characters

title string Optional

A title, at most 120 characters; written from the facts when left out Up to 120 characters

body string Optional

The update in Markdown, at most 4,000 characters; written from the facts when left out Up to 4000 characters

Upload images 4

Covers, screenshots and logos, from a link or pasted. Needs the write scope; counted as image uploads.

set_article_cover

Needs write

Set an article draft's cover DestructiveNot idempotent

Sets the cover image of one of the signed-in person's draft articles, replacing any cover it has. The image is cropped to 16:9 around its center at 1600 by 900, as the editor does. Published articles can't be changed here. Returns the cover's public address. Give the image exactly one way: uploadId, from create_image_upload once its file was sent (use it for any file on this machine or anything over about 50 KB, rather than base64); imageUrl, a public https address Shipfolio downloads (no private or local addresses); or imageBase64 with mimeType (image/png, image/jpeg, image/webp or image/gif), only for a tiny image. At most 8 MB (5 MB for a logo). It is re-encoded as WebP without its metadata. Counts as an image upload, which has its own daily limit; an uploadId was counted when its file arrived. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

articleId string (uuid) Required

The draft article's id, from create_article_draft or list_my_articles

uploadId string (uuid) Optional

The uploadId from create_image_upload, after its file was sent to uploadUrl. Works once, within 15 minutes

imageUrl string Optional

A public https address of the image Up to 2000 characters

imageBase64 string Optional

A tiny image's bytes as base64 (a data: URL is accepted). For a file, use uploadId instead Up to 11188904 characters

mimeType string Optional

With imageBase64: image/png, image/jpeg, image/webp or image/gif Up to 40 characters

add_listing_screenshot

Needs write

Add a screenshot to my product Not destructiveNot idempotent

Adds a screenshot at the end of one of the signed-in person's product galleries (at most 50 a product). It keeps its shape, scaled down so its longest side is at most 2000 pixels. Without alt text Shipfolio writes one from the image. Calling twice adds it twice. Returns its public addresses. Give the image exactly one way: uploadId, from create_image_upload once its file was sent (use it for any file on this machine or anything over about 50 KB, rather than base64); imageUrl, a public https address Shipfolio downloads (no private or local addresses); or imageBase64 with mimeType (image/png, image/jpeg, image/webp or image/gif), only for a tiny image. At most 8 MB (5 MB for a logo). It is re-encoded as WebP without its metadata. Counts as an image upload, which has its own daily limit; an uploadId was counted when its file arrived. Needs the write scope. Before calling, show the user exactly what will change and wait for them to confirm.

listing string Required

The listing's slug or id Up to 100 characters

uploadId string (uuid) Optional

The uploadId from create_image_upload, after its file was sent to uploadUrl. Works once, within 15 minutes

imageUrl string Optional

A public https address of the image Up to 2000 characters

imageBase64 string Optional

A tiny image's bytes as base64 (a data: URL is accepted). For a file, use uploadId instead Up to 11188904 characters

mimeType string Optional

With imageBase64: image/png, image/jpeg, image/webp or image/gif Up to 40 characters

alt string Optional

What the screenshot shows, for screen readers and search, at most 160 characters Up to 160 characters

caption string Optional

A caption under it, at most 200 characters Up to 200 characters

device string Optional

The frame it is shown in: Desktop (a browser window, the default), Phone or Tablet One of Desktop Phone Tablet Default Desktop

create_image_upload

Needs write

Start an image file upload Not destructiveNot idempotent

Makes a single-use link to send an image file straight to Shipfolio, so it never has to be pasted into a tool call as base64. Use it for any image that is a file on this machine or larger than about 50 KB, in preference to imageBase64: call this, run the returned curl command with your shell, putting the image's path after the @ (or PUT the file's raw bytes to uploadUrl with any HTTP tool; POST works too), then pass uploadId to set_article_cover, add_listing_screenshot or set_listing_logo. The link needs no sign-in, takes one file of at most maxBytes, and expires after 15 minutes (expiresAt); the type is read from the file's bytes (PNG, JPEG, WebP or GIF). Making the link is free; the file counts as one image upload when it arrives, and the image tool doesn't count it again. Needs the write scope. It changes nothing by itself: confirm the change with the user before calling the image tool that uses it.

purpose string Required

What the image is for: ArticleCover (set_article_cover), Screenshot (add_listing_screenshot) or Logo (set_listing_logo) One of ArticleCover Screenshot Logo

mimeType string Optional

The file's type, for the curl command's Content-Type: image/png, image/jpeg, image/webp or image/gif. Optional; Shipfolio reads the type from the bytes Up to 40 characters

Prompts

Ready-made workflows your client can offer as commands. Each one fills in a prompt from what you give it.

analyze_competitor_stack

Analyze a competitor's stack

Work out what a competitor is built with, what it likely costs, and what to learn from it.

product Required

The competitor's product slug or name

mine Optional

Your own product's slug, to compare against

plan_my_launch

Plan my launch

Get one of your products ready to launch on Shipfolio and plan the day.

listing Required

Your listing's slug, from list_my_listings

day Optional

The day you want to launch, yyyy-MM-dd (UTC)

improve_my_listing

Improve my listing

Review one of your products against its niche and suggest what would make it rank and convert better.

listing Required

Your listing's slug, from list_my_listings

Limits and quotas

Limits are per person, across every app you connect. Pro means Company Pro or the Investor plan.

LimitFreePro
Requests a minute3090
Search calls a day150600
Lookups a day4001,500
Account reads a day3001,000
Writes a day100300
Image uploads a day20100
Different products a day3001,000
  • Lists hold at most 20 results a page and stop at page 5. No call returns more than 50 items.
  • There is no export or "list everything" tool. Ask narrower questions instead.
  • Image tools take a public https link or the image itself as base64, at most 8 MB. Shipfolio downloads links only from the public internet and re-encodes every image as WebP without its metadata.
  • For an image file on your machine, the assistant calls create_image_upload, sends the file to the link it returns (a curl PUT, no sign-in needed), then passes the uploadId to the image tool. Each link takes one file and lasts 15 minutes. Base64 is for tiny images only.
  • Fetching more than 60 different products in 10 minutes pauses your MCP access for 1 hour.
  • Past a limit, the tool answers with an error that starts with RateLimited:, QuotaExceeded: or Paused: and says when it resets. Daily counts reset at midnight UTC.

Need more? Company Pro raises every limit for your whole team.

Fair use

The MCP server is for working with Shipfolio as yourself: running your listings and researching what you read. Bulk collection is not allowed. Don't use it, or any script behind it, to scrape, mirror or build datasets of products, founders, stacks or revenue.

Every call is logged with your account, the app, the tool and a fingerprint of its arguments, and kept for 30 days. Accounts that mine data are paused, then suspended or banned, which also stops their API keys and connected apps.

Automated access is covered by the terms, like everything else on Shipfolio.