FOUNDER TOOLKIT / MCP

StartupBar MCP

Your founder workspace,
one conversation away.

Connect an AI assistant to your startups, traffic and campaigns. Find your next milestone, understand what’s working, and manage your listings without jumping between pages.

Streamable HTTP OAuth protected 12 documented tools
Your assistantYour request
You authorizeSecure account sign-in
Your StartupBarReal listings & performance
01 / GET CONNECTED

One address. Your own account.

MCP (Model Context Protocol) is a standard that lets assistants call StartupBar’s tools directly, rather than guessing from website text. Use a client that supports remote MCP over Streamable HTTP with OAuth sign-in.

SERVER URLhttps://startupbar.co/mcp
  1. 1

    Add a remote MCP connection

    Open your assistant’s integrations or MCP connections and choose a custom remote server. Names and availability differ between clients and plans.

  2. 2

    Paste the server URL

    Use the address above and choose OAuth if asked. Do not paste a password, browser session token or secret key into the assistant.

  3. 3

    Sign in and approve

    Complete StartupBar sign-in and review the requesting client on the consent screen. Approve only a client you trust; denying leaves it disconnected.

  4. 4

    Start with your startups

    Ask “List my startups on StartupBar.” The assistant should call list_my_startups and use the returned startup IDs for later requests.

Endpoint available · sign-in required

The published address responds with an authentication requirement and OAuth discovery information. This guide documents the newest 12-tool revision; that revision requires publication. External approve/deny and the complete hosted catalog have not yet been verified.

02 / START A CONVERSATION

Less clicking. Better questions.

Understand your growth

“Compare my startups’ last complete week with the week before. Which gained the most clicks?”

Keep your listing fresh

“Update my startup’s one-liner and send the change for review. Keep its current approved text live.”

Find what needs attention

“Check my startup’s bar installation and explain what I need to fix.”

03 / THE COMPLETE REFERENCE

Twelve tools. Real founder jobs.

Private reads and changes act only on the connected account. Public discovery tools return approved, non-banned network listings. Inputs not listed in a tool’s schema are rejected.

list_my_startupsYour startups
Read

List your own startups, approval state and plain-language bar status.

Arguments & limits

No arguments.

Example request

“List all my startups and tell me which need attention.”
search_startupsDiscover the network
Read

Find approved, non-banned startups by name or category.

Arguments & limits

query: optional name, up to 100 characters · category: optional supported category · limit: 1–50, default 20.

Example request

“Find productivity startups on StartupBar.”
submit_startupAdd a startup
Write

Save an application draft, return the installation snippet, then submit for review after verification. Never charges or approves automatically.

Arguments & limits

name: 2–60 characters · website_url: public HTTP/HTTPS URL, up to 200 characters · description: 10–100 characters · category: required · placement: top or bottom, default top · submit: default false · startup_id: returned draft ID, required when submit is true.

Example request

“Prepare my startup application and give me the installation snippet. Do not submit it yet.”
get_startup_performanceTraffic and delivery
Read

Read received and delivered impressions/clicks, CTR, daily history, approval, bar status and Guaranteed Clicks progress.

Arguments & limits

startup_id: required owned ID · period: 7d (default), 30d or all. Calendar periods include today in UTC; all-time daily history covers the last seven days.

Example request

“How many impressions and clicks did my startup receive and deliver in the last seven days?”
get_leaderboardNetwork rankings
Read

Rank public approved startups by impressions received or delivered.

Arguments & limits

period: today, 7d (default) or all · direction: received (default) or delivered · limit: 1–50, default 20.

Example request

“Show the top startups by impressions received this week.”
get_leaderboard_standingYour positions
Read

Get positions for up to 100 owned startups, oldest first, and the impression gap to the preceding startup. Non-approved listings are not ranked.

Arguments & limits

period: today, 7d (default) or all · direction: received (default) or delivered.

Example request

“Where do all my startups rank, and how far are they from the next position?”
edit_startupUpdate a listing
Write

Update text, category or an existing own-folder logo. Approved text edits wait for review while the current text stays live. Category and logo changes apply immediately.

Arguments & limits

startup_id: required · name, description and category: optional, same limits as submission · logo_url: existing logo in your StartupBar upload folder, or null to restore the favicon. New image uploads use Account; website URLs cannot be changed.

Example request

“Update my startup’s one-liner and submit the text change for review.”
remove_startupSafe removal
Confirmation

Return a link to the owned listing’s Account confirmation. The tool itself never deletes. You must choose Yes, delete on the website.

Arguments & limits

startup_id: required owned ID. Removal is permanent after confirmation; it does not cancel subscriptions or issue refunds.

Example request

“Prepare removal of my startup and show me the confirmation link.”
check_startup_installationInstallation help
Read

Check the published site and explain matching-ID, security-policy and other installation issues. A negative scan does not prove removal. Eligible Supporters need no visible bar.

Arguments & limits

startup_id: required owned ID. A website check can be unavailable; use Account to retry. This does not change approval or billing.

Example request

“Check why my bar is not appearing and give me the correct snippet.”
get_campaign_statusCampaign progress
Read

Read click-pack delivery, banner review/dates/actual traffic and newsletter booking status without paying, booking or changing campaigns.

Arguments & limits

startup_id: optional owned ID, filters clicks and newsletters only · limit: 1–50 per type, default 20. Banners are account-wide. Prices are stored cents in USD; booked recipients are not proof of email delivery or opens.

Example request

“Show my click-pack progress, banner review status and newsletter bookings.”
compare_startup_performanceCompare growth
Read

Compare equal, complete UTC periods for received/delivered traffic and CTR. Excludes today; percentage change is unavailable over a zero baseline.

Arguments & limits

startup_id: optional owned ID; omit for up to 20 listings, oldest first · period: 7d (default) or 30d. Request an individual ID for other listings.

Example request

“Compare all my startups’ last complete seven days with the previous seven days.”
book_guaranteed_clicksBook Guaranteed Clicks
Write

Create a secure checkout link for an approved, non-banned startup you own. Review and pay yourself; creating the link never charges you or starts delivery.

Arguments & limits

startup_id: required owned approved ID · clicks: 100 ($49), 250 ($99), 500 ($179) or 1000 ($299), one-time USD. Payment must be verified before fulfillment.

Example request

“Set up 250 Guaranteed Clicks for my startup and give me the payment link.”
Supported startup categories

AI · Developer Tools · Productivity · Marketing & Sales · Design · Creator & Media · E-commerce · Finance · Education · Health & Wellness · Community · Other

04 / WORK WITH CONFIDENCE

From a question to the next step.

Adding a startup

Prepare a draft → install its matching snippet → verify the published site → explicitly submit for review. The first listing is free; additional listings use the existing $9.99 payment flow or an eligible prepaid credit. A duplicate consumes no new payment. Submission never means approval.

Booking Guaranteed Clicks

Choose your approved startup and a one-time pack → ask for a checkout link → open the secure payment page → review and pay yourself. Packs cost $49/100, $99/250, $179/500 or $299/1,000 clicks. Creating a link does not charge you or start delivery; verified payment is required. Ask for campaign status afterward.

Editing an approved listing

Name and description changes wait for review while approved text stays live. Category and existing uploaded-logo changes apply immediately. Upload new images from Account; the website URL is fixed.

Removing a startup

Ask for removal → open the returned Account link → review the warning → choose Yes, delete or Cancel yourself. The AI tool never deletes directly. Confirmed removal is permanent and does not cancel billing or issue refunds.

Reading performance correctly

Received means your startup was shown or clicked. Delivered means your site showed or sent a click to another startup. CTR is received clicks divided by received impressions. Performance windows include today; comparisons deliberately use complete UTC days excluding today. Clicks do not prove signups or revenue.

05 / PERMISSIONS & SAFETY

Connected, not uncontrolled.

  • Account-scoped access

    Private startup data, changes and campaign reads stay restricted to the signed-in owner. Startup IDs are references, not permission to access another founder’s data.

  • Use OAuth, not copied credentials

    The server requires OAuth-issued client tokens. Normal browser-session tokens are not a connection method. Disconnect from your assistant’s integration controls when you no longer want it connected.

  • Payments and review remain separate

    Tools can prepare a Guaranteed Clicks payment link, but cannot charge you or complete payment, auto-approve a listing, submit StartupBid bids, send emails or bypass installation requirements. Review changes before asking an assistant to apply them.

Browser-local tools are separate: Network and Leaderboard expose read-only page data; Account can open the existing removal confirmation when Your startups is visible. They depend on browser support and do not replace the remote MCP connection. See Privacy and Terms.

06 / WHEN SOMETHING DOESN’T WORK

A few useful checks.

The URL says unauthorized

That is expected when opening the protected server without OAuth. Connect it through your assistant and finish account authorization; it is not a normal web page.

My assistant cannot connect

Confirm remote Streamable HTTP and OAuth support in that client. Use the exact server URL. If sign-in or consent fails, reconnect and retry rather than sharing tokens or switching to public access.

I cannot see the newest tools

The guide describes the latest revision. It must be published before external assistants can discover it. After publication, refresh or reconnect the integration; a generated catalog alone does not prove hosted availability.

My startup is missing or unranked

Check you authorized the correct founder account. Private tools use owned IDs; public discovery and rankings include approved, non-banned listings only.

The scan cannot confirm my bar

Security policy, matching-ID, consent and conditional installation can affect detection. Bundled or inner-page installs may not appear in a static scan. Missing evidence does not prove removal; retry from Account.

My comparison has no percentage change

A zero previous count has no meaningful percentage baseline. The tool returns the actual difference and leaves percentage change empty rather than inventing growth.