Skip to main content
Glama

RelayLink

List contacts

list_contacts
Read-onlyIdempotent

List accepted contacts the user can send packages to, the requests waiting on them, and the requests they have sent. Use the exact email shown — it is the contact's only RelayLink address; other addresses you may know for this person will not resolve. The list changes between your calls — the user accepts and renames in their browser as readily as through you — so call this again rather than answer from an earlier result when a name the user gives is not one you recognise.

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": "list_contacts"
  }
}

Input Schema

NameRequiredDescriptionDefault
tagNoNarrow accepted contacts to this tag — the user's own private label, from list_tags. Omit for everyone.
queryNoOptional: only contacts whose name, nickname or address contains this text (case-insensitive). Omit for everyone.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior4/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 genuinely non-structured behavior: the list is volatile because the user mutates it out-of-band in a browser, and addresses not returned here will not resolve. It stops short of describing result ordering or volume.

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 in the first sentence, with the two caveats following in service of it. Each sentence carries distinct information, though the third sentence is wordier than it needs to be for the point it makes.

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 only two optional params, no output schema and rich annotations, the definition covers what an agent needs: what is returned, how fresh it is, and how to reference contacts. Only pagination/result-size expectations are left unstated, a minor gap for a list tool.

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 100% and both parameters (tag, query) are fully documented in the schema, including the pointer to list_tags. The description never mentions filtering at all, so it adds nothing beyond the schema — 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 specific verb and resource ("List accepted contacts") and then enumerates exactly what the result contains: accepted contacts, inbound pending requests, and sent requests. That scope distinguishes it cleanly from list_tags, list_groups, list_threads and invite_contact without needing the schema.

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?

Gives an explicit operational rule — re-call rather than answer from an earlier result when a name is not recognised — plus a hard constraint to use the exact email shown. It does not name an alternative sibling for a given situation, so it stops short of full when/when-not routing.

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