toolfound

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Free-text search: product name, problem, or tag (e.g. 'invoicing', 'screenshot api')."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "The product slug, e.g. 'acme-analytics' (from search results or the listing URL)."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Slug of the product to find alternatives for."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ],
      "description": "Leaderboard window: day, week, or month."
    }
  },
  "required": [
    "period"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The upcoming toolfound launch calendar with seat availability per date: featured seats (a scarce, limited number per day) vs how many are already taken, plus the total daily cap and how many launches are queued, over a horizon you choose (default 30 days, up to 180). Also returns the suggested launch date (about a week out — enough time to line up your first supporters) and how many of the first-100 free launch slots remain. toolfound shows all of this openly — no hidden queues. Use it to pick a launch date before submitting: pass preferred_launch_date to toolfound_submit_product to claim a specific day.

{
  "type": "object",
  "properties": {
    "horizon_days": {
      "description": "How many days ahead to return (default 30, max 180).",
      "type": "integer",
      "minimum": 1,
      "maximum": 180
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Submit a product to launch on toolfound.com — the launch platform where the whole launch runs agent-native, end to end. New submissions require a public URL for the maker-selected product logo; a discovered favicon does not count. One call returns everything: your submission id, ownership-verification instructions (mandatory — DNS TXT, meta tag, or email magic link), transparent queue position and assigned launch date, and the live free-slots counter (launches are free). AGENTS: you do not need inbox access — the verify_token in this response works with the meta_tag or dns_txt method via toolfound_verify_submission, and toolfound_check_verification dry-runs the checks; the emailed magic link is a human fallback that can also be completed later from the dashboard. Description renders as plain-text paragraphs on the listing page: 100–200 words reads best, and entries over 100 words qualify for search-engine indexing. Resubmitting a known URL returns the existing submission (idempotent and grandfathered when the existing row predates the logo requirement).

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 4,
      "maxLength": 500,
      "description": "The product's public https URL (e.g. https://yourproduct.com)."
    },
    "email": {
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Maker's email — receives the verification link, queue updates, and launch results."
    },
    "name": {
      "description": "Product name (optional — drafted from the site if omitted).",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "tagline": {
      "description": "One-line tagline (optional).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "description": {
      "description": "Longer description (optional — you can edit later).",
      "type": "string",
      "minLength": 1,
      "maxLength": 5000
    },
    "logo_url": {
      "description": "Direct public URL for the product's real logo (PNG, JPG, GIF or WebP; max 2MB). Required for new submissions.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "x_handle": {
      "description": "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.",
      "type": "string",
      "maxLength": 120
    },
    "preferred_launch_date": {
      "description": "Preferred launch date, YYYY-MM-DD (optional). Must be within the next 180 days; use toolfound_get_launch_calendar to find open featured 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.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "pricing_model": {
      "description": "The product's pricing model (optional, but strongly recommended — captured now instead of after claim so the listing never sits at 'Pricing unlisted').",
      "type": "string",
      "enum": [
        "free",
        "freemium",
        "trial",
        "paid",
        "unknown"
      ]
    },
    "price_usd": {
      "description": "Optional starting price in USD (e.g. the cheapest paid plan). Only used when pricing_model is 'paid', 'freemium', or 'trial'.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "url",
    "email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "description": "The verify_token returned by toolfound_submit_product."
    }
  },
  "required": [
    "token"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "description": "The verification token from your submission email or verification snippet."
    }
  },
  "required": [
    "token"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Check the status of a toolfound submission by submission id or product URL: current state (pending verification, queued, launched), transparent queue position, assigned launch date, and the listing URL once live. toolfound never hides queue state — what this returns is exactly what everyone sees.

{
  "type": "object",
  "properties": {
    "submission_id": {
      "description": "The submission id returned by toolfound_submit_product.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "url": {
      "description": "Or the product URL you submitted.",
      "type": "string",
      "minLength": 4,
      "maxLength": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Slug of the listing to claim."
    },
    "email": {
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Your email — ideally at the product's own domain — receives the claim magic link."
    }
  },
  "required": [
    "slug",
    "email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Relaunch an already-launched toolfound listing: same listing, same URL, a new launch date shown alongside the old one. The listing goes back on that day's board; board points there are counted from votes cast since the NEW launch date, while the original launch and its vote total stay on the page as history. Requires one line describing what changed since the original launch (required, shown publicly on the listing page). Only available once the listing has been live at least 30 days since it last launched or relaunched, and at most once every 30 days after that. Only the claimed owner, or the email that verified the original submission, can call this.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Slug of the listing to relaunch."
    },
    "email": {
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Must match the claimed-owner email or the email that verified the original submission: this is the ownership check, there is no separate verification step."
    },
    "note": {
      "type": "string",
      "minLength": 10,
      "maxLength": 200,
      "description": "Required: one line about what changed since the original launch (10-200 characters). Shown publicly on the listing page."
    },
    "requested_launch_date": {
      "description": "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.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "slug",
    "email",
    "note"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Slug of the listing to get badges for."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}