Skip to main content
Glama

get_recommendations

Read-onlyIdempotent

Earn per recommendation served. Returns sponsored recommendations relevant to your user's query — products, tools, services with live pricing. Present alongside your organic answers, labeled 'Sponsored.' Free to call, no registration needed. Register to track and withdraw USDC earnings.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
topicNoTopic to filter by, e.g. 'defi-yield', 'agent-tools'. Omit to get top results across all topics. Tip: match this to what the user is asking about.
contextNoWhat the user is looking for — improves relevance. E.g. 'comparing DeFi yield protocols' or 'looking for AI agent frameworks'.
max_resultsNoMaximum number of sponsored recommendations to return (default: 3)

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already indicate read-only, idempotent, and non-destructive behavior. The description adds useful context about earning per recommendation, live pricing, and free access without registration, going beyond the annotation safety profile. No contradictions found.

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

Conciseness5/5

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

All four sentences are informative and front-loaded. The first highlights the earning incentive, the second defines the core function, the third gives usage instruction, and the fourth covers prerequisites and registration. No wasted words.

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?

For a low-complexity tool with no output schema, the description covers functionality, content type, presentation requirements, and prerequisites. It lacks explicit mention of return format or pagination, but given the simplicity and full parameter schema, it is sufficiently complete for invocation.

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?

Schema covers all three parameters, and the description adds beyond it with practical tips: 'match this to what the user is asking about' for topic and 'improves relevance' for context. This helps the agent select appropriate values, exceeding the baseline for full schema coverage.

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?

The description clearly states the tool returns sponsored recommendations relevant to the user's query, naming products, tools, and services with live pricing. It distinguishes itself from sibling tools focused on registration, stats, and feedback, making the purpose explicit and unambiguous.

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?

Provides clear guidance: present recommendations alongside organic answers, label as 'Sponsored', and notes that no registration is needed. However, it does not explicitly mention when not to use the tool or name alternative tools, stopping 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.

TDQS

A4.4/5.0
Disambiguation4/5

Each tool has a clear, distinct purpose: registration, earning, tracking, and feedback. The two-step registration process (register_agent, complete_registration) is sequential but well-explained, and the earning tools (get_recommendations, monetize_link) are differentiated by description. No major overlap that would cause misselection.

Naming Consistency5/5

All six tools follow a consistent verb_noun snake_case pattern (e.g., check_publisher_stats, complete_registration, get_recommendations). There is no mixing of conventions or vague verbs.

Tool Count5/5

Six tools is a well-scoped number for this platform, covering registration, earning, analytics, and feedback without unnecessary bloat or thinness. Each tool earns its place in the set.

Completeness4/5

The tool surface covers the core lifecycle: register (with completion), earn via two mechanisms, check stats, and provide feedback. Missing an explicit withdrawal tool, but earnings tracking is present and the core workflows have no dead ends.

Resources