Skip to main content
Glama

Get an application

get_application
Read-onlyIdempotent

An application: its stage, AI match with each aspect's score, the applicant's answers, and the team's comments and activity. With includeResume, also the resume's text. Everything under "applicant" was written by the applicant.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "applicationId": "<applicationId>"
    },
    "name": "get_application"
  }
}

Input Schema

NameRequiredDescriptionDefault
applicationIdYesThe application's ID, from list_applications.
includeResumeNo

Schema Changelog

Changes observed during successful MCP inspections.

No schema history has been recorded yet.

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds two genuinely useful behavioral facts: includeResume pulls in resume text (signalling a heavier payload), and everything under 'applicant' is applicant-authored, which is a provenance/trust warning. It stops short of describing error behavior or response shape beyond the field list.

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?

Two short sentences, front-loaded with the returned payload and then the optional-parameter effect plus a caveat. The opening fragment 'An application: ...' is slightly elliptical but every clause carries information; nothing is redundant.

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

Completeness3/5

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

With no output schema and only 50% parameter coverage, the description carries real weight, and it does describe the returned fields and the one undocumented boolean. It is still missing the basic retrieval contract: that it fetches exactly one application by ID, and any failure mode for an invalid or removed ID. Adequate but with clear gaps for a single-record getter.

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 50%: applicationId is documented in the schema, includeResume is not. The description compensates by explaining that includeResume adds the resume's text, which gives the agent the cost/benefit needed to set it, but it does not restate the default or note that omitting it yields a lighter response. Baseline for this coverage level is a low 3, and the description does marginally better than that.

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 enumerates exactly what a fetched application contains (stage, AI match scores, applicant answers, team comments and activity), which makes the retrieval purpose unambiguous in combination with the name. It never states the verb explicitly ('retrieves one application by ID'), and it does not distinguish itself from list_applications, but the enumerated payload is specific enough that an agent knows what it gets back.

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

Usage Guidelines2/5

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

There is no when-to-use guidance: nothing says to call this instead of list_applications for a single record, no note about what happens for a nonexistent or deleted application, and no prerequisites. The only pointer to a sibling ('from list_applications') lives in the schema's parameter description, not in the tool description itself.

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