Skip to main content
Glama

AIsa Sales

by one.aisa
OverviewDiscussionsAdmin

Creator AI Search

post_waveinflu_ai_search
Destructive

Finds creators from a natural-language brief instead of a seed account. platform and query are required; add limit (1–100, default 40) and the same optional filters as Similar Creators. Describe the creators you want in plain language (for example, "beauty creators in the US") and the response returns matching creators in the same rich shape as Similar Creators — full profile metrics plus AI-inferred gender, ageRange, ethnicity, faceVisibility, accountPositioning, aiDescription, and a relevance score. Billing is per delivered creator (data.count).

Usage-based billing; Default request estimate: $0.124425 USD (not a fixed price). Declared unit rate: $0.004977 USD per similar_creator_point. Account-specific pricing and final settlement may differ.

Input Schema

NameRequiredDescriptionDefault
bodyYes

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / body
      Added value: +{
+  "properties": {
+    "filters": {
+      "description": "Optional filters applied before matching. All fields are optional.",
+      "properties": {
+        "creatorTypes": {
+          "description": "Creator account types, e.g. [\"individual\", \"brand\"].",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "ethnicities": {
+          "description": "Inferred creator ethnicities.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "faceVisibilities": {
+          "description": "Face-visibility classifications, e.g. [\"clear_face\", \"mixed\", \"no_face\"].",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "genders": {
+          "description": "Inferred creator genders, e.g. [\"female\", \"male\"].",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "languages": {
+          "description": "Creator languages, e.g. [\"en\", \"ja\", \"zh-cn\"].",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "maxFollowers": {
+          "description": "Maximum follower / subscriber count.",
+          "type": "number"
+        },
+        "maxPlayCount": {
+          "description": "Maximum play / view count, measured by `playCountMetric`.",
+          "type": "number"
+        },
+        "minFollowers": {
+          "description": "Minimum follower / subscriber count.",
+          "type": "number"
+        },
+        "minPlayCount": {
+          "description": "Minimum play / view count, measured by `playCountMetric`.",
+          "type": "number"
+        },
+        "playCountMetric": {
+          "description": "Whether `minPlayCount` / `maxPlayCount` are compared against the median or the average play count.",
+          "enum": [
+            "median",
+            "average"
+          ],
+          "type": "string"
+        },
+        "regions": {
+          "description": "Creator regions (ISO country codes), e.g. [\"US\", \"GB\", \"JP\"].",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "workspaceDeduplicationEnabled": {
+          "description": "When true, creators already saved in your workspace are excluded from the results.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "limit": {
+      "default": 25,
+      "description": "Maximum number of creators to return. Default 25, range 1–100. Caps the billed count.",
+      "example": 10,
+      "maximum": 100,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "platform": {
+      "default": "youtube",
+      "description": "Target platform.",
+      "enum": [
+        "instagram",
+        "tiktok",
+        "youtube"
+      ],
+      "example": "instagram",
+      "type": "string"
+    },
+    "query": {
+      "description": "Natural-language description of the creators you are looking for.",
+      "example": "beauty creators in the US",
+      "type": "string"
+    }
+  },
+  "required": [
+    "query"
+  ],
+  "type": "object"
+}
    • removedInput schema / properties / filters
      Removed value: -{
-  "description": "Optional filters applied before matching. All fields are optional.",
-  "properties": {
-    "creatorTypes": {
-      "description": "Creator account types, e.g. [\"individual\", \"brand\"].",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "ethnicities": {
-      "description": "Inferred creator ethnicities.",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "faceVisibilities": {
-      "description": "Face-visibility classifications, e.g. [\"clear_face\", \"mixed\", \"no_face\"].",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "genders": {
-      "description": "Inferred creator genders, e.g. [\"female\", \"male\"].",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "languages": {
-      "description": "Creator languages, e.g. [\"en\", \"ja\", \"zh-cn\"].",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "maxFollowers": {
-      "description": "Maximum follower / subscriber count.",
-      "type": "number"
-    },
-    "maxPlayCount": {
-      "description": "Maximum play / view count, measured by `playCountMetric`.",
-      "type": "number"
-    },
-    "minFollowers": {
-      "description": "Minimum follower / subscriber count.",
-      "type": "number"
-    },
-    "minPlayCount": {
-      "description": "Minimum play / view count, measured by `playCountMetric`.",
-      "type": "number"
-    },
-    "playCountMetric": {
-      "description": "Whether `minPlayCount` / `maxPlayCount` are compared against the median or the average play count.",
-      "enum": [
-        "median",
-        "average"
-      ],
-      "type": "string"
-    },
-    "regions": {
-      "description": "Creator regions (ISO country codes), e.g. [\"US\", \"GB\", \"JP\"].",
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    "workspaceDeduplicationEnabled": {
-      "description": "When true, creators already saved in your workspace are excluded from the results.",
-      "type": "boolean"
-    }
-  },
-  "type": "object"
-}
    • removedInput schema / properties / limit
      Removed value: -{
-  "default": 25,
-  "maximum": 100,
-  "minimum": 1,
-  "type": "integer"
-}
    • removedInput schema / properties / platform
      Removed value: -{
-  "default": "youtube",
-  "enum": [
-    "instagram",
-    "tiktok",
-    "youtube"
-  ],
-  "type": "string"
-}
    • removedInput schema / properties / query
      Removed value: -{
-  "description": "Natural-language description of the creators you are looking for.",
-  "example": "beauty creators in the US",
-  "type": "string"
-}
    • changedInput schema / required
      Previous value: -[
-  "query"
-]New value: +[
+  "body"
+]
  2. Changed8 schema fields changed
    • changedInput schema / properties / limit / default
      Previous value: -40New value: +25
    • removedInput schema / properties / limit / description
      Removed value: -"Maximum number of creators to return. Default 40, range 1–100. Caps the billed count."
    • removedInput schema / properties / limit / example
      Removed value: -10
    • changedInput schema / properties / limit / type
      Previous value: -"number"New value: +"integer"
    • addedInput schema / properties / platform / default
      Added value: +"youtube"
    • removedInput schema / properties / platform / description
      Removed value: -"Target platform."
    • removedInput schema / properties / platform / example
      Removed value: -"instagram"
    • changedInput schema / required
      Previous value: -[
-  "platform",
-  "query"
-]New value: +[
+  "query"
+]
  3. Changed8 schema fields changed
    • changedInput schema / properties / limit / default
      Previous value: -25New value: +40
    • addedInput schema / properties / limit / description
      Added value: +"Maximum number of creators to return. Default 40, range 1–100. Caps the billed count."
    • addedInput schema / properties / limit / example
      Added value: +10
    • changedInput schema / properties / limit / type
      Previous value: -"integer"New value: +"number"
    • removedInput schema / properties / platform / default
      Removed value: -"youtube"
    • addedInput schema / properties / platform / description
      Added value: +"Target platform."
    • addedInput schema / properties / platform / example
      Added value: +"instagram"
    • changedInput schema / required
      Previous value: -[
-  "query"
-]New value: +[
+  "platform",
+  "query"
+]
  4. Changed8 schema fields changed
    • changedInput schema / properties / limit / default
      Previous value: -40New value: +25
    • removedInput schema / properties / limit / description
      Removed value: -"Maximum number of creators to return. Default 40, range 1–100. Caps the billed count."
    • removedInput schema / properties / limit / example
      Removed value: -10
    • changedInput schema / properties / limit / type
      Previous value: -"number"New value: +"integer"
    • addedInput schema / properties / platform / default
      Added value: +"youtube"
    • removedInput schema / properties / platform / description
      Removed value: -"Target platform."
    • removedInput schema / properties / platform / example
      Removed value: -"instagram"
    • changedInput schema / required
      Previous value: -[
-  "platform",
-  "query"
-]New value: +[
+  "query"
+]
  5. Added

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations mark this readOnly=false, destructive=true and idempotent=false, which is unusual for a search tool; the description resolves that by disclosing usage-based billing ('Billing is per delivered creator (data.count)') plus a concrete per-unit rate and estimate. That cost/consumption context is exactly the kind of behavior structured fields cannot convey. It does not spell out auth requirements or rate limits, so it falls short of a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the differentiator and required inputs, then response shape, then billing — a sensible ordering with little filler. The appended pricing comment block is boilerplate rather than author content, but it does lengthen the definition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers the essentials for a billed, non-idempotent search: input meaning, output richness (redundant given the output schema exists), and cost. The one soft spot is that the filter set is described only by cross-reference ('the same optional filters as Similar Creators'), forcing an agent to consult a sibling to know the full filter surface.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds conceptual value (limit 'caps the billed count', the AI-inferred output fields), but it conflicts with the schema on two points: it calls `platform` required when the schema requires only `query` and gives platform a default, and it states `limit` defaults to 40 while the schema says 25. With reported schema coverage at 0% for the top-level `body` wrapper, the description is carrying the burden and these inaccuracies are costly, though the nested filter and platform properties are individually documented.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb and resource ('Finds creators') and immediately states the distinguishing mechanism: a natural-language brief rather than a seed account. This separates it cleanly from the sibling post_waveinflu_similar_creators, which is seed-driven, so an agent can pick between the two without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear condition for use ('Describe the creators you want in plain language') and contrasts it against the seed-account approach, implicitly naming the alternative path. It stops short of an explicit 'when not to use this / use similar_creators instead' instruction, so routing still requires a small inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AIsa Sales toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources