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
- Search products by niche, tool, pricing or verified revenue search_products niche_overview
- See what a product is built with, and compare two stacks get_product_stack compare_stacks
- Find alternatives to a product or a tool product_alternatives tool_alternatives
- Follow launches and the Making Money board launches making_money
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 Open connector settings Settings Connectors Add custom connector Open Claude
- 2 Name it Shipfolio and paste the URL Copy
- 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.
~/.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 Your client opens Shipfolio in your browser Sign in as you normally do, with Google, GitHub or your email.
- 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 Choose the access Read is always included. Tick "Make changes" only if you want the app to edit your listings.
- 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.
| Scope | Lets 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.
| Limit | Free | Pro |
|---|---|---|
| Requests a minute | 30 | 90 |
| Search calls a day | 150 | 600 |
| Lookups a day | 400 | 1,500 |
| Account reads a day | 300 | 1,000 |
| Writes a day | 100 | 300 |
| Image uploads a day | 20 | 100 |
| Different products a day | 300 | 1,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.