Skip to main content
Glama

List Applications

list_applications
Read-onlyIdempotent

List the user's imported UGC creator applications (best fit first) with status, fit score, recommendation, handles, answers and review notes. Pass application_id for one application with its account and video analysis. Use before reviewing or drafting responses. Free.

Input Schema

NameRequiredDescriptionDefault
uidNoOptional Firebase uid. Must match the URL uid unless local fallback is enabled.
limitNoPage size, 1-100 (default 25).
cursorNoThe next_cursor from the previous page. Keep the other filters identical.
statusNo
bearer_tokenNoOptional Firebase ID token. Hosted clients normally authenticate with an API key header or ?uid= in the URL instead.
application_idNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint and destructiveHint=false, so the safety profile is covered. The description adds genuinely new context: result ordering ('best fit first'), the fields surfaced, and cost ('Free'). It does not discuss paging behavior despite a cursor parameter.

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?

Three sentences, front-loaded with the core capability and sorting rule, then the single-record mode, then the usage cue. The field enumeration is long but each item conveys what will be returned, so little is wasted.

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 no output schema, the description usefully enumerates returned fields and the two result shapes (list vs single application). The main gap is pagination guidance for a tool that exposes limit and cursor; otherwise an agent has what it needs to call correctly.

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?

Schema coverage is 67%, with limit, cursor and uid documented in the schema. The description compensates for the undocumented application_id by explaining it switches to a single-application view that additionally includes account and video analysis. It says nothing about the status enum filter or interaction between filters.

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

Purpose4/5

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

The description names a specific verb+resource ('list the user's imported UGC creator applications') and enumerates the fields returned (status, fit score, recommendation, handles, answers, review notes) plus the sort order. It implicitly separates this read from mutation siblings like review_applications and update_application_status, though it never names them.

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?

'Use before reviewing or drafting responses' gives a clear ordering cue relative to draft_application_response and review_applications, and 'Pass application_id for one application' explains the single-record mode. There is no explicit when-not-to-use statement, keeping it short of a 5.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources