IA Selecta

Search the IA Selecta catalog of live, published AI tools by a free-text query. Matches on tool name, tagline, or category name (case-insensitive substring). Call this first when a user asks to find, discover, or compare AI tools by keyword, use-case, or category (e.g. 'agents', 'writing assistants'). Returns up to 20 results.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Free-text search term, e.g. a tool name, use-case, or category."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "site": {
            "type": "string"
          },
          "toolUrl": {
            "type": "string"
          },
          "logoUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "faviconUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "name",
          "tagline",
          "url",
          "category",
          "site",
          "toolUrl",
          "logoUrl",
          "faviconUrl"
        ],
        "additionalProperties": false
      },
      "description": "Matching live listings, newest first, capped at 20."
    }
  },
  "required": [
    "results"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Fetch the full public detail for one AI tool by its listing slug (as returned by search_tools' toolUrl, e.g. '/tools/acme-writer' -> slug 'acme-writer'). Call this after search_tools to get a tool's full description, launch date, revenue signals (verified or self-reported), and for-sale status. Returns null if the slug doesn't resolve to a live IA Selecta listing.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "The tool's listing slug."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "tool": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "tagline": {
              "type": "string"
            },
            "description": {
              "type": "string"
            },
            "url": {
              "type": "string"
            },
            "category": {
              "type": "string"
            },
            "launchDate": {
              "type": "string",
              "description": "ISO 8601 timestamp of the real launch date."
            },
            "toolUrl": {
              "type": "string"
            },
            "logoUrl": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "faviconUrl": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "ogImageUrl": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "verifiedMrrUsd": {
              "description": "Present only when the maker connected Stripe.",
              "type": "number"
            },
            "revenueVerifiedAt": {
              "description": "ISO 8601 timestamp of the last Stripe verification.",
              "type": "string"
            },
            "selfReportedMrrUsd": {
              "description": "Present only when the figure is the maker's own claim.",
              "type": "number"
            },
            "selfReported": {
              "description": "Marks selfReportedMrrUsd as unverified. Never report it as verified.",
              "type": "boolean",
              "const": true
            },
            "forSale": {
              "type": "boolean",
              "const": true
            },
            "askingPriceUsd": {
              "type": "number"
            }
          },
          "required": [
            "name",
            "tagline",
            "description",
            "url",
            "category",
            "launchDate",
            "toolUrl",
            "logoUrl",
            "faviconUrl",
            "ogImageUrl"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "null when the slug does not resolve to a live listing on this site."
    }
  },
  "required": [
    "tool"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

List live, same-category alternatives to a well-known AI tool (e.g. 'chatgpt', 'notion-ai', 'figma'). Call this when a user asks 'what are the alternatives to X' or wants competitors/substitutes for a named product. `target` is the well-known tool's slug, not a listing slug from this catalog.

{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Slug of the well-known target tool, e.g. 'chatgpt'."
    }
  },
  "required": [
    "target"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "target": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "url": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "null when the target slug is not a known product."
    },
    "alternatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "tagline": {
            "type": "string"
          },
          "toolUrl": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "tagline",
          "toolUrl"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "target",
    "alternatives"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Submit a new AI tool to IA Selecta on behalf of its maker. Creates a draft listing (not yet public) and returns a claimUrl the maker must visit to sign up and claim/publish it. Call this only when a user explicitly wants to list their own tool — never to submit a tool on someone else's behalf without their email. Rate-limited globally to 5 submissions per hour. Supply tagline, problemSolved, logoUrl and imageUrls whenever you can: they are what make the published listing look like a real product page rather than a stub.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "The tool's name."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The tool's https homepage URL."
    },
    "description": {
      "type": "string",
      "minLength": 40,
      "maxLength": 1000,
      "description": "A description of the tool (40-1000 chars)."
    },
    "category": {
      "type": "string",
      "description": "Category slug, e.g. 'agents', 'writing', 'coding', 'design', 'marketing', 'productivity', 'video', 'analytics'."
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The maker's email — used to claim the listing on signup."
    },
    "tagline": {
      "description": "One line shown on every card (max 60 chars). Supply it — without one we fall back to a truncated description.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "problemSolved": {
      "description": "What problem the tool solves, in the maker's words (max 160 chars). Rendered as its own block on the listing page.",
      "type": "string",
      "maxLength": 160
    },
    "xHandle": {
      "description": "X/Twitter handle, without the @.",
      "type": "string"
    },
    "xHandleIsFounder": {
      "description": "True when the handle is the founder's personal account rather than the product's.",
      "type": "boolean"
    },
    "logoUrl": {
      "description": "https URL of the tool's logo. We copy it to our own storage — we never hotlink the maker's host.",
      "type": "string",
      "format": "uri"
    },
    "imageUrls": {
      "description": "Up to 5 https screenshot URLs, best first. Copied to our own storage. Without any, the listing shows a generated placeholder card instead of a real screenshot.",
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    }
  },
  "required": [
    "name",
    "url",
    "description",
    "category",
    "email"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "claimUrl": {
      "description": "Where the maker signs up to claim the DRAFT. Present only when ok is true.",
      "type": "string"
    },
    "error": {
      "type": "string"
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

List the optional paid add-ons a maker can buy to promote their listing (name, one-sentence effect, price in USD). Listing is always free; these only ADD reach and are always labeled 'Sponsored'. Call this to see what's purchasable before create_checkout. During free early access (early-bird), offers are not yet purchasable and this says so (purchasable=false).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "purchasable": {
      "type": "boolean",
      "description": "False during free early access — nothing can be bought."
    },
    "note": {
      "type": "string"
    },
    "offers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "whatItDoes": {
            "type": "string"
          },
          "priceUsd": {
            "type": "number"
          }
        },
        "required": [
          "key",
          "name",
          "whatItDoes",
          "priceUsd"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "site",
    "purchasable",
    "note",
    "offers"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Create a Stripe checkout URL for one paid add-on on one listing, and return it for a HUMAN to open. Never present this as a completed purchase: nothing is charged until a person completes checkout in a browser. Returns an error when the listing doesn't exist, the add-on isn't purchasable yet (free early access), or payments aren't configured in this environment.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "The listing's slug (as in a toolUrl, e.g. '/tools/acme-writer' -> 'acme-writer')."
    },
    "product": {
      "type": "string",
      "enum": [
        "premium_launch",
        "review_one",
        "review_monthly",
        "network_all",
        "network_three"
      ],
      "description": "Add-on key: premium_launch, review_one, review_monthly, network_all, network_three. See list_offers for names, effects, and prices."
    }
  },
  "required": [
    "slug",
    "product"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "checkoutUrl": {
      "description": "A URL a HUMAN must open. Nothing is charged until a person completes it.",
      "type": "string"
    },
    "instruction": {
      "type": "string"
    },
    "error": {
      "type": "string"
    }
  },
  "required": [
    "ok"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}