Skip to main content
Glama

Edgar & Edgarette: SEC Filing Boards

watch_company

Ask Edgar (POPS4) to email a person the day a company files with the SEC. Needs the person's email and the company name as it files (or its CIK). Each note carries a one-click stop link.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
cikNooptional SEC CIK, exact match
boardNo
emailYes
companyYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.9/5.0
Behavior3/5

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

With no annotations, the description carries the full burden. It discloses the main side effect (sending an email), the recipient requirement, and the one-click stop link, which is useful. However, it does not mention whether this creates a recurring subscription, how often emails are sent, failure behavior, or any permission/consent considerations.

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?

The description is three tight sentences. It front-loads the core action, then gives prerequisites, then adds a useful behavioral detail about the stop link. No filler or redundancy.

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?

For a side-effecting tool with no annotations and no output schema, this is reasonably complete: it covers the trigger, inputs, and unsubscribe mechanism. However, it omits the meaning of the 'board' parameter and gives no indication of what the agent should expect as a response or confirmation.

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?

The description adds meaning for 'company' (exact filing name), 'email' (the person's email), and 'cik' (alternative identifier). But schema coverage is only 25%, and the 'board' enum parameter is completely unexplained in both schema and description, leaving a notable gap.

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 states a specific action ('email a person') tied to a precise trigger ('the day a company files with the SEC'). This clearly distinguishes watch_company from the sibling get_* tools, which retrieve data rather than send email alerts.

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?

It gives clear context: use this when someone should be notified by email about an SEC filing. It also states the required inputs (email, company name or CIK). It does not explicitly list alternatives or when-not-to-use, but the action is distinct enough from the sibling retrieval tools that the intended use is evident.

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.