---
canonical_url: "https://docs.composio.dev/toolkits/toolfound_mcp"
markdown_url: "https://docs.composio.dev/toolkits/toolfound_mcp.md"
product: "platform"
version: null
last_updated: null
---

# Toolfound MCP

Search and compare software tools, prepare product launches, submit products, verify ownership, and track launches on Toolfound.

- **Category:** marketing
- **Auth:** NO_AUTH
- **Composio-managed OAuth available?** N/A
- **Tools:** 32
- **Triggers:** 0
- **Slug:** `TOOLFOUND_MCP`
- **Version:** 00000000_00

## Tools

### Toolfound campaign links

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_CAMPAIGN_LINKS`

Create one deterministic UTM link while retaining unrelated query parameters and the page anchor. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `medium` | string | Yes | The channel type (utm_medium), such as email, social, referral or cpc. |
| `source` | string | Yes | Where the traffic comes from (utm_source), such as the newsletter, site or platform name. |
| `content` | string | No | Optional label (utm_content) that tells apart variants within one campaign, such as which button or placement. |
| `campaign` | string | Yes | The campaign or launch name (utm_campaign) used to group results in analytics, for example october_launch. |
| `websiteUrl` | string | Yes | Destination page that visitors should land on. Existing query parameters and any #anchor are kept in the result. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound campaign url cleaner

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_CAMPAIGN_URL_CLEANER`

Normalize UTM naming or remove standard utm_* campaign parameters (utm_source, utm_medium, utm_campaign and similar) from a supplied URL without visiting its destination. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The full public campaign URL to clean, including its query string. The page is never fetched. Fragments and non-UTM parameters are left untouched. |
| `mode` | string ("normalize" | "remove") | Yes | What to do with the utm_* parameters: normalize keeps them but rewrites the values into lowercase underscore naming such as launch_news, remove strips them all to give a clean shareable link. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound check verification

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_CHECK_VERIFICATION`

Non-destructive dry run of ownership verification for a Toolfound submission: reports, per method, what the checker sees RIGHT NOW — meta tag found or not (with the exact expected tag), DNS TXT found or not (with the exact expected record), and whether the submission email qualifies for the magic-link path. Use it to distinguish 'my deploy is not live yet' from 'wrong token' before calling toolfound_verify_submission. Changes nothing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `token` | string | Yes | The verify_token returned by toolfound_submit_product. |

### Toolfound claim listing

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_CLAIM_LISTING`

Claim an existing Toolfound listing as the product's owner (free). Claiming requires ownership verification — a magic link is sent to the email you provide (use an address at the product's domain), and meta-tag / DNS TXT verification also works. Claimed listings unlock editing, badges, analytics, and the optional open-to-acquisition flag.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `slug` | string | Yes | Slug of the listing to claim. |
| `email` | string | Yes | Your email — ideally at the product's own domain — receives the claim magic link. |

### Toolfound color contrast

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_COLOR_CONTRAST`

Calculate the WCAG text contrast ratio for two opaque hex colors before shipping a landing page or launch graphic. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `background` | string | Yes | Background colour the text sits on, as an opaque hex code with a leading hash, for example #ffffff. |
| `foreground` | string | Yes | Text colour as an opaque hex code with a leading hash, for example #1a2b3c or #fff. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound csv deduplicator

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_CSV_DEDUPLICATOR`

Clean repeated campaign or listing-export rows while retaining the first exact match and showing how many rows changed. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `csv` | string | Yes | CSV text whose first line is the header row, for example a campaign or listing export. Rows that exactly repeat an earlier row are dropped and the first copy is kept. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound directory matcher

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_DIRECTORY_MATCHER`

Filter the dated launch-directory evidence by product fit, cost, format, and link policy. Use it when you are choosing where to list or launch a product and want a shortlist of directories that fit your product type, budget, listing format and backlink needs. Returns the matching directories from dated evidence with their recorded cost, format and link policy; it checks nothing live. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cost` | string ("any" | "free" | "paid" | "unknown") | Yes | Whether getting listed costs money. free keeps directories with at least one free path, paid keeps those that only charge, unknown keeps those with no recorded price. any skips the filter. |
| `segment` | string ("any" | "b2b-saas" | "ai-tools" | "dev-tools" | "side-projects" | "ai-directories" | "mcp-registries" | "high-authority") | Yes | The kind of product you are launching, used to keep only directories that accept that kind of product. Use any to skip this filter. |
| `dofollow` | string ("any" | "yes" | "no" | "conditional" | "unknown") | Yes | The recorded policy on whether the directory's backlink to your site passes SEO value (a followed link). conditional means it depends on a rule such as a plan or a rank. unknown means not yet verified. any skips the filter. |
| `launchModel` | string ("any" | "daily-ranking" | "weekly-ranking" | "monthly-ranking" | "evergreen-listing" | "community" | "review-site" | "deal-marketplace" | "database" | "newsletter" | "unknown") | Yes | How the directory presents a listing: time-boxed rankings (daily, weekly, monthly), a permanent evergreen listing, a community post, a review site, a deal marketplace, a tool database or a newsletter feature. any skips the filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound distribution plan

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_DISTRIBUTION_PLAN`

Turn a launch date and up to eight chosen channels into a bounded preparation timetable. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channels` | string | Yes | Comma or newline separated list of the channels you will use, for example community, newsletter, social. Order matters: the earlier channels get earlier preparation dates and the last one falls on launch day. |
| `launchDate` | string | Yes | The day you plan to launch, as a calendar date in YYYY-MM-DD form. Preparation steps are counted back from this day. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound feedback interview planner

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_FEEDBACK_INTERVIEW_PLANNER`

Create a bounded interview plan and evidence log from a learning goal, participant count, and available time. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `goal` | string | Yes | The one product decision the interviews should inform, written as a sentence such as Decide which onboarding step to simplify. |
| `stage` | string ("evaluating" | "new" | "active" | "churned") | Yes | Where the people you interview are with your product: evaluating it, new users, active users, or people who stopped using it. This picks the opening question. |
| `minutes` | string | Yes | Length of each interview in minutes, as a whole number, for example 30. |
| `participants` | string | Yes | How many people you can interview, as a whole number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound find by task

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_FIND_BY_TASK`

Match a plain-language task description against public Toolfound catalogue evidence. Use it when someone asks which tool can do a specific job, such as converting invoices or scheduling social posts, and you want listed candidates rather than a general web search. Returns up to a handful of matching listings with name, tagline, listing URL, pricing model, the terms that matched and any limitations. Results are not personal recommendations and unknown capabilities remain unknown.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task` | string | Yes | The job to get done, described in everyday words, for example send invoices to clients. Name the outcome, not a product. |
| `pricing` | string ("any" | "free" | "free_or_freemium") | No | Optional pricing filter. free keeps only free tools, free_or_freemium also keeps tools with a free tier, any applies no filter. Listings with unknown pricing are excluded when a filter is set. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `error` | string | No |  |
| `query` | string | Yes |  |
| `matches` | array | Yes |  |
| `warnings` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound get alternatives

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_GET_ALTERNATIVES`

List alternatives to a given product on Toolfound — tools in the same primary category, ranked by points (community votes plus an AI listing score). Useful for 'alternatives to X' and comparison questions. Each result includes tagline, pricing model, votes, and a canonical listing URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `slug` | string | Yes | Slug of the product you want substitutes for, taken from a search result or listing URL. Results are listings in the same category. |

### Toolfound get badge

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_GET_BADGE`

Get the three copy-paste badge embed snippets for a Toolfound listing ('live on Toolfound', 'verified', 'top 3 this week' variants). Badges are optional and earned — they deep-link to the listing with varied anchor text, and the embedder chooses the rel attribute freely. Listing status is never conditioned on embedding a badge.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `slug` | string | Yes | Slug of the listing that needs embed snippets, taken from its toolfound.com URL. The badges link back to this listing. |

### Toolfound get launch calendar

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_GET_LAUNCH_CALENDAR`

Get upcoming Toolfound launch dates and seat availability over a chosen horizon (default 30 days, maximum 180 days). The response distinguishes featured capacity, total daily capacity, and queued launches. Launching is free, and preferred_launch_date on toolfound_submit_product requests a specific date. The response can also include the free launch date and current paid offers with prices, availability, and checkout URLs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `horizon_days` | integer | No | How far into the future to list launch dates, counted in days from today. Use a short horizon to find the next open date, a long one to plan ahead. |

### Toolfound get launch status

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_GET_LAUNCH_STATUS`

Check a Toolfound submission by submission ID or product URL. Returns its current state, queue position, assigned launch date, and listing URL once live. The response can also include the free launch date and current paid offers with prices, earlier availability, and checkout URLs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | Or the product URL you submitted. |
| `submission_id` | string | No | The submission id returned by toolfound_submit_product. |

### Toolfound get product

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_GET_PRODUCT`

Fetch the full Toolfound listing for a product by slug: description, tagline, pricing model, tags, socials, vote count, launch date, ownership-verification status, and the canonical listing URL. Every launched listing on Toolfound is ownership-verified by its maker (DNS TXT, meta tag, or domain email). Includes the top alternatives in the same category. Adds verified_metrics when Toolfound has fetched fresh data for the listing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `slug` | string | Yes | The product slug, e.g. 'acme-analytics' (from search results or the listing URL). |

### Toolfound get trending

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_GET_TRENDING`

The Toolfound leaderboard: top products launched in the last day, week, or month, ranked by points (community votes plus an AI listing score). Toolfound is a launch platform with a transparent queue — every product here launched publicly on an assigned date and is ownership-verified. Great for 'what launched recently' and 'trending tools' questions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `period` | string ("day" | "week" | "month") | Yes | How far back to rank launches, counted from now. Short windows show what is hot today, longer windows show sustained winners. |

### Toolfound get verified board

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_GET_VERIFIED_BOARD`

Boards of listings ranked by data Toolfound fetched itself within the last 7 days: revenue band via Stripe, GitHub stars, or App Store rating. A board is visible only once at least 10 listings have data of that kind; otherwise it returns visible false and no entries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `board` | string ("revenue" | "stars" | "rated") | Yes | Which kind of Toolfound-fetched data to rank by: Stripe revenue band, GitHub stars, or App Store rating. Check the visible flag in the response, since a board stays hidden until enough listings have data. |

### Toolfound inspect public link

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_INSPECT_PUBLIC_LINK`

Safely fetch one public HTTPS source page and report matching anchor markup for a public HTTPS target, including observed rel tokens. This does not establish indexing, crawler treatment, or ranking impact. Redirect history is reported as unobserved.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sourceUrl` | string | Yes | Public HTTPS page whose fetched HTML is inspected. |
| `targetUrl` | string | Yes | Public HTTPS destination to match exactly, ignoring fragments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `error` | object | No |  |
| `fetch` | object | Yes |  |
| `summary` | string | Yes |  |
| `evidence` | object | Yes |  |
| `fetchedAt` | string | Yes |  |
| `sourceUrl` | string | Yes |  |
| `targetUrl` | string | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound json to csv

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_JSON_TO_CSV`

Convert a small flat JSON export into a downloadable spreadsheet, with explicit limits and formula protection. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `json` | string | Yes | A JSON array of flat objects (no nested objects or arrays), for example an analytics or launch export. Each object becomes one CSV row and the keys become the column headers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound launch readiness

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_LAUNCH_READINESS`

Check whether an editable product draft has the fields needed for a complete directory submission. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Your product's public name as it should appear in a directory listing. |
| `logoURL` | string | No | Public HTTPS address of the logo image directories will show. Must be reachable without login. |
| `tagline` | string | No | One-line summary of what the product does and for whom. |
| `websiteUrl` | string | No | Public HTTPS address of the product's website or landing page. |
| `description` | string | No | Original description written for this listing, covering the problem, audience, workflow and limits. Short drafts are flagged as incomplete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound launch review

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_LAUNCH_REVIEW`

Calculate transparent signup and conversion rates from the non-negative counts you provide. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `visits` | integer | Yes | Number of tracked visits to your launch page in the measurement window, as a plain count. |
| `signups` | integer | Yes | Number of those visitors who signed up, as a plain count. The signup rate is signups divided by visits. |
| `conversions` | integer | No | Optional number of signups who became paying customers, as a plain count. Leave out if unknown, and the paid conversion rate is reported as unknown. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound list categories

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_LIST_CATEGORIES`

List every category in the Toolfound directory with product counts and curated intros. Use this to browse the index or to map a user's need to the right category before searching.

### Toolfound listing copy

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_LISTING_COPY`

Turn supplied product facts into deterministic, editable listing copy without inventing claims. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Your product's public name. |
| `outcome` | string | Yes | The specific result a user gets once the problem is solved. |
| `problem` | string | Yes | The concrete problem your audience has today, in your own words. The copy is built from this text and does not add claims. |
| `audience` | string | Yes | Who the product is for, as a short phrase such as independent design teams. |
| `differentiator` | string | No | Optional: what your approach does differently from existing options. Only stated facts are used. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound newsletter readiness

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_NEWSLETTER_READINESS`

Build an honest pitch checklist from the materials editors usually need before they can review a launch. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Your product's public name. |
| `logoURL` | string | No | Public HTTPS address of a logo editors can use. Must be reachable without login. |
| `audience` | string | No | The readers who would care about this news, for example operations teams at small software companies. |
| `newsAngle` | string | No | What is new or newsworthy right now, such as a release or workflow change. Editors look for this first. |
| `websiteUrl` | string | No | Public HTTPS address of the product site an editor would visit. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound relaunch

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_RELAUNCH`

Relaunch an already-launched Toolfound listing: same listing, same URL, a new launch date shown alongside the old one. Relaunch requires a fresh verified-owner session, so this anonymous MCP transport reports the eligibility result but directs owners to the dashboard to authorize the write.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | Yes | Required: one line about what changed since the original launch (10-200 characters). Shown publicly on the listing page. |
| `slug` | string | Yes | Slug of the listing to relaunch. |
| `email` | string | Yes | Claimed-owner email. The relaunch must still be authorized from its verified dashboard session. |
| `requested_launch_date` | string | No | Preferred new launch date, YYYY-MM-DD, within the next 180 days. Use toolfound_get_launch_calendar to find open featured seats. Falls back to the earliest open day if omitted or full. |

### Toolfound relaunch decision

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_RELAUNCH_DECISION`

Choose between a relaunch, a regular update, or more preparation from the size of the change and launch evidence you provide. Use it when you have already launched and are unsure whether to relaunch, post a regular update, or prepare more first. Returns one of three verdicts (plan a relaunch, publish a regular update, prepare before promoting) with the reasons and next actions, based only on the answers given. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `change` | string ("small" | "major" | "direction") | Yes | Size of the biggest change since your last launch: small is incremental improvements, major is a new workflow or a new audience, direction is a different product direction. |
| `evidence` | string ("strong" | "release" | "none") | Yes | What you can show for the update: strong is a working release plus specific proof such as a demo or numbers, release is a working release only, none means it is not released yet. |
| `listingCurrent` | string ("yes" | "no") | Yes | yes if your public listing, screenshots and facts already match the product as it is today. |
| `audienceChanged` | string ("yes" | "no") | Yes | yes if the people you are targeting are different from the last launch. |
| `measurementReady` | string ("yes" | "no") | Yes | yes if tracking, support ownership and a review date are already in place for the announcement. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound search tools

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_SEARCH_TOOLS`

Search toolfound.com — the launch platform and tool directory built agent-first — for SaaS products and developer tools by name, tagline, or tag. Returns matching products with taglines, pricing model, vote counts, and canonical listing URLs you can cite or open. Use this when a user asks to find, compare, or discover a tool for a job.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | What to look for: a product name, a problem it solves, or a tag, such as 'invoicing' or 'screenshot api'. Matching is keyword based, so specific nouns work better than full sentences. |

### Toolfound share preview

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_SHARE_PREVIEW`

Export a safe 1200×630 SVG preview from a bounded product name and tagline. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Product name printed as the headline of the preview image. |
| `tagline` | string | Yes | Short supporting line printed under the name in the preview image. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound software cost comparison

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_SOFTWARE_COST_COMPARISON`

Normalize two software prices to a first-year cost using seats, billing periods, setup fees, and expected usage charges. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `aName` | string | Yes | Label for the first option, used in the result. |
| `bName` | string | Yes | Label for the second option, used in the result. |
| `seats` | string | Yes | Number of people who will need a licence, as a whole number. Both options are priced for this same count. |
| `aPrice` | string | Yes | Option A list price per seat in US dollars as a plain number. It is per month when aBilling is monthly, per year when annual, and a single payment when one-time. |
| `aSetup` | string | No | Optional one-time setup or onboarding fee for option A in US dollars. Defaults to 0 when omitted. |
| `aUsage` | string | No | Optional expected usage-based charges for option A in US dollars per month, such as overages. Counted for 12 months. Defaults to 0. |
| `bPrice` | string | Yes | Option B list price per seat in US dollars as a plain number. It is per month when bBilling is monthly, per year when annual, and a single payment when one-time. |
| `bSetup` | string | No | Optional one-time setup or onboarding fee for option B in US dollars. Defaults to 0 when omitted. |
| `bUsage` | string | No | Optional expected usage-based charges for option B in US dollars per month, such as overages. Counted for 12 months. Defaults to 0. |
| `aBilling` | string ("monthly" | "annual" | "one-time") | Yes | How option A's price is charged: monthly prices are multiplied by 12 for the first year, annual and one-time prices are counted once. |
| `bBilling` | string ("monthly" | "annual" | "one-time") | Yes | How option B's price is charged: monthly prices are multiplied by 12 for the first year, annual and one-time prices are counted once. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound sponsorship break even

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_SPONSORSHIP_BREAK_EVEN`

Estimate the clicks, signups, and customers needed to recover a sponsorship cost from your own funnel assumptions. Returns an evidence-bounded result and the canonical web tool URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cost` | string | Yes | Price of the sponsorship in US dollars as a plain number, for example 500. No currency symbol. |
| `margin` | string | Yes | Gross margin on that revenue as a percentage, so 80 means 80 percent (not 0.8). |
| `revenue` | string | Yes | Revenue one new customer brings in during your measurement window, in US dollars as a plain number. |
| `signupRate` | string | Yes | Share of sponsorship clicks that become signups, as a percentage, so 12 means 12 percent. |
| `customerRate` | string | Yes | Share of signups that become paying customers, as a percentage, so 8 means 8 percent. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ok` | boolean | Yes |  |
| `data` | object | No |  |
| `links` | array | Yes |  |
| `errors` | object | No |  |
| `summary` | string | Yes |  |
| `sections` | array | Yes |  |
| `canonical_result_url` | string | Yes |  |

### Toolfound submit product

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_SUBMIT_PRODUCT`

Submit a product to launch on Toolfound. Returns the submission ID, mandatory ownership-verification instructions for DNS TXT, meta tag, or email magic link, queue position, assigned launch date, free-slot information, and any available paid offers. The verification token can be checked with toolfound_check_verification and used with toolfound_verify_submission after the DNS or meta-tag proof is in place. A logo URL is optional; Toolfound uses the site's icon when omitted. Descriptions of more than 100 words qualify for search-engine indexing. Resubmitting a known URL returns the existing submission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The product's public https URL (e.g. https://yourproduct.com). |
| `name` | string | No | Product name (optional — drafted from the site if omitted). |
| `email` | string | Yes | Maker's email — receives the verification link, queue updates, and launch results. |
| `tagline` | string | No | One-line tagline (optional). |
| `logo_url` | string | No | Direct public URL for the product's real logo (PNG, JPG, GIF or WebP; max 2MB). Optional; defaults to the site's icon. |
| `x_handle` | string | No | The maker's X (Twitter) handle, e.g. @yourproduct (optional). Shown on the listing. If the listing wins that UTC day, @toolfoundcom tags this handle the next morning. We do not tag every launch. |
| `price_usd` | number | No | Optional starting price in USD (e.g. the cheapest paid plan). Only used when pricing_model is 'paid', 'freemium', or 'trial'. |
| `description` | string | No | Longer description (optional — you can edit later). |
| `pricing_model` | string ("free" | "freemium" | "trial" | "paid" | "unknown") | No | The product's pricing model (optional, but strongly recommended — captured now instead of after claim so the listing never sits at 'Pricing unlisted'). |
| `founder_x_handle` | string | No | Founder's X handle, shown on the listing and tagged if the launch tops its day |
| `preferred_launch_date` | string | No | Preferred launch date, YYYY-MM-DD (optional). Must be within the next 180 days. Free launches cannot take today or tomorrow: a date earlier than the next free date is moved to it (a later date is honoured). Use toolfound_get_launch_calendar to find open seats. If that day is full by the time you verify, the earliest open day is assigned and reported. Omit to get the earliest open date automatically. |

### Toolfound verify submission

**Slug:** `TOOLFOUND_MCP_TOOLFOUND_VERIFY_SUBMISSION`

Complete the mandatory ownership verification for a Toolfound submission using the verification token (from the email magic link, or after placing the meta tag / DNS TXT record on your domain — this call checks them on demand). Verification is what makes Toolfound listings trustworthy: every launched product is confirmed maker-owned. On success your launch is queued at the transparent position and date you were assigned.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `token` | string | Yes | Secret verification token for one submission, found in the email link or in the meta tag or DNS record snippet shown after submitting. Treat it as a credential and use it only for your own submission. |
