Skip to main content
Glama
Sign In

StealAds

by ai.stealads
OverviewDiscussionsAdmin

Get available actions

get_capabilities
Read-onlyIdempotent

Returns what this connection can do: every available tool with the scope it needs and whether the connection has it, which tools are read-only, page-size caps, request rate, cursor lifetime, the reading allowance, and the rules for cost previews and confirmation. A useful second call after whoami. Reports permissions only; it does not test whether ad generation is currently available.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_capabilities"
  }
}

Input Schema

NameRequiredDescriptionDefault
response_formatNoOutput format: text (default) or json. table is not available for this tool.

Output Schema

NameRequiredDescriptionDefault
toolsNoTools offered on this connection and whether its permissions allow them.
limitsNoEffective request, page and reading limits for this connection.
billingNoCredit quoting and confirmation rules.
discoveryNoAccount scopes and reference meanings.
runtime_readinessNoProvider readiness was not probed by this discovery call.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / response_format / description
      Previous value: -"Output format: text or json for capped research examples; table is available only for tracked rival rows."New value: +"Output format: text (default) or json. table is not available for this tool."
  2. Changed1 schema field changed
    • changedOutput schema / properties / limits / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "description": "Effective request, page and reading limits for this connection.",
-    "properties": {
-      "cursor_lifetime_seconds": {
-        "anyOf": [
-          {
-            "description": "Seconds a continuation handle remains usable.",
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Seconds a continuation handle remains usable."
-      },
-      "library_max_pages": {
-        "anyOf": [
-          {
-            "description": "Maximum continuation depth of a library search.",
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Maximum continuation depth of a library search."
-      },
-      "page_caps": {
-        "anyOf": [
-          {
-            "description": "Maximum result count for each bounded tool page or sample.",
-            "items": {
-              "additionalProperties": false,
-              "description": "Maximum result count for each bounded tool page or sample.",
-              "properties": {
-                "max_results": {
-                  "anyOf": [
-                    {
-                      "description": "max results value in this response.",
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "max results value in this response."
-                },
-                "tool": {
-                  "anyOf": [
-                    {
-                      "description": "tool value in this response.",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "description": "tool value in this response."
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Maximum result count for each bounded tool page or sample."
-      },
-      "rate_limit_scope": {
-        "anyOf": [
-          {
-            "description": "Whether requests count per API key or per OAuth grant and user.",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Whether requests count per API key or per OAuth grant and user."
-      },
-      "reading_allowance": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "description": "Daily scanned-row allowance for this workspace, resetting at midnight UTC.",
-            "properties": {
-              "daily_limit": {
-                "description": "Maximum scanned rows allowed per UTC day.",
-                "type": "number"
-              },
-              "remaining": {
-                "description": "Scanned rows still available today.",
-                "type": "number"
-              },
-              "resets_at": {
-                "description": "ISO timestamp when the allowance or credits reset.",
-                "type": "string"
-              }
-            },
-            "required": [
-              "daily_limit",
-              "remaining",
-              "resets_at"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Daily scanned-row allowance for this workspace, resetting at midnight UTC."
-      },
-      "requests_per_minute": {
-        "anyOf": [
-          {
-            "description": "Effective per-minute request cap; negative means no configured cap.",
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Effective per-minute request cap; negative means no configured cap."
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "description": "Effective request, page and reading limits for this connection.",
+    "properties": {
+      "cursor_lifetime_seconds": {
+        "anyOf": [
+          {
+            "description": "Seconds a continuation handle remains usable.",
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Seconds a continuation handle remains usable."
+      },
+      "library_max_pages": {
+        "anyOf": [
+          {
+            "description": "Maximum continuation depth of a library search.",
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Maximum continuation depth of a library search."
+      },
+      "page_caps": {
+        "anyOf": [
+          {
+            "description": "Maximum result count for each bounded tool page or sample.",
+            "items": {
+              "additionalProperties": false,
+              "description": "Maximum result count for each bounded tool page or sample.",
+              "properties": {
+                "max_results": {
+                  "anyOf": [
+                    {
+                      "description": "max results value in this response.",
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "max results value in this response."
+                },
+                "tool": {
+                  "anyOf": [
+                    {
+                      "description": "tool value in this response.",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "tool value in this response."
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Maximum result count for each bounded tool page or sample."
+      },
+      "rate_limit_scope": {
+        "anyOf": [
+          {
+            "description": "Whether requests count per API key or per OAuth grant and user.",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Whether requests count per API key or per OAuth grant and user."
+      },
+      "reading_allowance": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "description": "Free daily ad-return allowance for this workspace, resetting at midnight UTC.",
+            "properties": {
+              "daily_limit": {
+                "description": "Maximum free ad examples returned per UTC day.",
+                "type": "number"
+              },
+              "remaining": {
+                "description": "Free ad examples still available today.",
+                "type": "number"
+              },
+              "resets_at": {
+                "description": "ISO timestamp when the allowance or credits reset.",
+                "type": "string"
+              }
+            },
+            "required": [
+              "daily_limit",
+              "remaining",
+              "resets_at"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Free daily ad-return allowance for this workspace, resetting at midnight UTC."
+      },
+      "requests_per_minute": {
+        "anyOf": [
+          {
+            "description": "Effective per-minute request cap; negative means no configured cap.",
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Effective per-minute request cap; negative means no configured cap."
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
  3. First observed

TDQS

A4.3/5.0
Behavior5/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), and the description adds substantial context on top: what the response contains, that scopes are reported per tool with whether the connection holds them, and — most importantly — the limitation that it reports permissions rather than verifying live availability. That caveat prevents a plausible misread of the output.

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?

Purpose is front-loaded and the enumeration is informative rather than padded, though the list is dense and one item ("the reading allowance") is vague enough to be near-noise. The closing caveat sentence is well placed.

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?

With an output schema present, the description needn't explain return values, yet it still summarizes them, and it flags the key interpretive limit. Minor gap: it doesn't indicate what an agent should do after discovering a missing scope, or mention the response_format choice at all.

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?

There is a single parameter at 100% schema coverage, and the schema already documents the text/json/table enum including the note that table is unavailable. The description adds nothing about response_format, so the baseline 3 applies.

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?

States a concrete verb and resource — returns what the connection can do — and then enumerates the specific contents (tool scopes, read-only flags, page-size caps, rate, cursor lifetime, cost-preview and confirmation rules). This is clearly an introspection/capability-discovery tool, distinct from data-fetching siblings like get_ad or get_usage.

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?

"A useful second call after whoami" gives explicit ordering guidance, and "Reports permissions only; it does not test whether ad generation is currently available" is a real exclusion. It stops short of naming which sibling does test generation availability, so the when-not is asserted without a redirect.

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

All StealAds 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