Skip to main content
Glama

Get the connected account

get_account
Read-onlyIdempotent

Get who this connection is authenticated as and which team it operates on, including the team timezone, how many monitors it has and whether its plan is active. Useful for grounding answers about "my" monitors and for telling which team a question applies to. See https://ohdear.app/docs/api/user-info.

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
teamYes
userYes
connectionYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.2/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 fully covered without the description. The description's added value is content disclosure (what account/team fields come back) and a doc link, but nothing about auth requirements, rate limits, or failure modes, so it is incremental rather than rich.

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-loaded with the primary answer (who the connection is authenticated as and which team), then supporting detail, then a doc link. The field enumeration is slightly list-heavy but each item earns its place by telling the agent what questions this tool can answer.

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

Completeness5/5

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

With an output schema present, return structure need not be spelled out, and annotations cover the read-only safety profile. Adding the enumerated fields plus the official doc URL makes this fully self-sufficient for a zero-argument context-fetch tool.

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

Parameters4/5

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

The tool takes zero parameters, so there is nothing for the description to disambiguate; per the rubric a 0-param tool baselines at 4. It correctly implies no arguments are needed by describing only contextual grounding value.

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 specific verb (get) and resource (the authenticated account/connection) and enumerates the concrete fields returned: authentication identity, team, timezone, monitor count, plan status. This clearly separates it from the sibling list_* tools, which enumerate monitors or destinations rather than the caller's own account.

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?

Explicitly frames when to reach for it: grounding answers about 'my' monitors and determining which team a question applies to. It gives clear positive context but names no alternative tool or exclusions, so it stops 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