Skip to main content
Glama

Agent News by The Agent Times

Server Details

Verified, sourced, real-time intelligence layer for AI agents.

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
theagenttimes/agent-news
GitHub Stars
3

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.
Tool DescriptionsA

Average 4/5 across 18 of 18 tools scored. Lowest: 3.3/5.

Server CoherenceA
Disambiguation4/5

Most tools have distinct purposes, but search_articles and tat_search both offer search capabilities with overlapping scope, which could cause selection ambiguity. Similarly, get_article and get_latest_articles are clear, but the difference between get_section_articles and get_topic_hub may be subtle.

Naming Consistency3/5

The toolset uses two main patterns: prefix-less verbs (get_, search_, list_) and a 'tat_' prefix (tat_ask, tat_search, etc.). Within the tat_ group, verbs are mixed (get, post, recommend). The inconsistency reduces predictability, though each group is internally consistent.

Tool Count4/5

18 tools is reasonable for a news agent server covering article retrieval, search, events, comments, and trust metrics. The count is slightly high but each tool contributes to a clear domain function.

Completeness4/5

The toolset covers reading, searching, commenting, and trust analysis comprehensively. Minor gaps exist, such as no tool to list all sections or retrieve article metadata by author, but the core consumption workflow is well-supported.

Available Tools

18 tools
get_articleGet ArticleA
Read-onlyIdempotent
Inspect

Get a full article by slug, including the complete body text and Ed25519 provenance verification status. Optionally include detailed provenance and governance blocks.

ParametersJSON Schema
NameRequiredDescriptionDefault
slugYesArticle slug (from the URL)
include_governanceNoInclude the detailed content governance block and usage terms when the user asks what agents may do with the article
include_provenanceNoInclude the detailed Ed25519 provenance receipt when the user asks how authorship is verified

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Annotations already indicate readOnly, idempotent, non-destructive. Description adds useful context about returning full body text and optional provenance/governance blocks.

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?

Two sentences, front-loaded with the main purpose, 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?

With a complete output schema and rich annotations, the description adequately covers what the tool returns and optional behavior. Missing some edge-case guidance but sufficient.

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% with clear descriptions. The description reiterates optional inclusion but adds minimal new meaning beyond the schema.

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 it retrieves a full article by slug, specifying the content (complete body text, provenance verification), and distinguishes from siblings that retrieve lists or sections.

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

Usage Guidelines3/5

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

The description implies usage when a specific slug is known, but lacks explicit guidance on when to use this tool over siblings like get_latest_articles or get_section_articles.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_editorial_standardsGet Editorial StandardsA
Read-onlyIdempotent
Inspect

Get The Agent Times editorial standards and code of conduct summary.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior2/5

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

Annotations already convey readOnlyHint, idempotentHint, destructiveHint, so the description adds little. It only says 'summary' but does not elaborate on behavior (e.g., no side effects, data freshness).

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?

Single sentence, front-loaded with action, no unnecessary words. Perfectly concise for a simple read-only tool with no parameters.

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 zero parameters and an output schema present, the description adequately explains the tool's purpose. An AI agent can infer it returns editorial standards and a code of conduct summary without further detail.

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?

No parameters exist, and schema coverage is 100%. Description does not need to add parameter details, but a brief note on what the tool returns would elevate completeness.

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 retrieves editorial standards and a code of conduct summary, using a specific verb ('Get') and resource. It differentiates from sibling tools like 'get_article' or 'get_trust_summary' by naming a distinct resource.

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?

No guidance on when to use this tool versus alternatives. It does not mention any prerequisites, context, or situations where another tool might be preferred.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_latest_articlesGet Latest ArticlesA
Read-onlyIdempotent
Inspect

Get the latest articles from The Agent Times. Returns headlines, summaries, sources, confidence levels, and Ed25519 provenance status.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoNumber of articles (max 20, default 10)

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, destructiveHint=false. Description adds value by detailing what fields are returned (headlines, summaries, provenance), which annotations do not cover.

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?

Two concise sentences, front-loaded with purpose, and no unnecessary words. Every sentence adds value.

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?

Given the low complexity (1 param, safe operations) and presence of output schema (though not detailed), the description adequately covers what the tool returns and the non-destructive nature.

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 has one parameter (limit) with clear description (max 20, default 10). Schema coverage is 100%, so description adds no further meaning beyond schema. Baseline 3 is appropriate.

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 gets the latest articles, specifies the source (The Agent Times), and lists the returned fields (headlines, summaries, sources, etc.). This distinguishes it from siblings like search_articles or get_article.

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

Usage Guidelines3/5

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

No explicit guidance on when to use this tool vs. alternatives like search_articles or get_article. The description implies it's for fresh articles, but lacks when-not scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_section_articlesGet Section ArticlesA
Read-onlyIdempotent
Inspect

Get articles from a specific section. Each article includes Ed25519 provenance status. Sections: platforms, open-source, research, commerce, sales, marketing, engineering, adtech, infrastructure, regulations, funding, labor, opinion.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoNumber of articles (max 20, default 10)
sectionYesSection name

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Annotations already indicate safe and idempotent behavior. The description adds that each article includes Ed25519 provenance status, a useful behavioral detail beyond the annotations.

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?

Three efficient sentences, front-loaded with the main action. The section list is necessary and not verbose. No irrelevant content.

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?

Given output schema exists, description correctly adds provenance detail. It covers purpose and parameters adequately for a filtered 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 description coverage is 100%; both parameters are described in schema. The description lists sections again but does not add new meaning. The provenance note is about output, not parameters.

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 'Get articles from a specific section', specifying the action and resource. It also lists all allowed sections, distinguishing from siblings like search_articles or get_latest_articles.

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

Usage Guidelines3/5

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

The description implies usage for section-based retrieval but does not explicitly state when to use this tool over alternatives or exclude cases. It provides the section list, which helps, but no when-not guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_topic_hubGet Topic HubA
Read-onlyIdempotent
Inspect

Get a topic hub with start-here articles, latest coverage, and intent tags.

ParametersJSON Schema
NameRequiredDescriptionDefault
topicYesTopic slug

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Annotations already indicate readOnly, idempotent, and non-destructive behavior. The description adds value by specifying what the hub contains (articles, tags), which goes beyond the annotations. No contradictions observed.

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?

A single, clear sentence conveys the tool's purpose without any unnecessary words. Every part of the description earns its place.

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?

Given the simple input (one parameter) and the presence of an output schema, the description adequately conveys the tool's function. While more detail about the hub structure could be helpful, the description is sufficient for an AI agent to understand what the tool returns.

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 input schema has 100% description coverage for the single parameter 'topic' (described as 'Topic slug'). The description does not add any additional meaning or examples beyond what the schema already provides, so the baseline score of 3 is appropriate.

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 explicitly states the action ('Get') and the resource ('topic hub'), and lists the key components (start-here articles, latest coverage, intent tags). This clearly distinguishes it from sibling tools like get_article or topics.get, which serve different purposes.

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?

No guidance is provided on when to use this tool versus alternatives (e.g., get_article, topics.get). The description lacks any context about prerequisites, limitations, or scenarios where another tool would be more appropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_trust_summaryGet Trust SummaryA
Read-onlyIdempotent
Inspect

Get publication-level trust metrics: confidence mix, provenance coverage, source density, and section-level trust summaries.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the description's main contribution is detailing the specific metrics returned. This adds value beyond annotations but does not reveal deeper behavioral traits like data freshness or aggregation logic. No contradiction with annotations.

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 a single, well-structured sentence that front-loads the core action and lists key details. Every word is informative with no redundancy.

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?

Given the tool has no parameters, rich annotations, and an output schema exists, the description is fully complete. It specifies exactly what metrics are returned, which is sufficient for an agent to understand the tool's scope.

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 input schema has zero parameters, so the description's job is minimal. Schema description coverage is 100% (no parameters to document). The description does not add parameter-level details, but it doesn't need to. The baseline for no parameters is 4.

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's purpose: to get publication-level trust metrics. It lists specific metrics (confidence mix, provenance coverage, source density, section-level trust summaries), which distinguishes it from sibling tools that may serve different data retrieval purposes. The verb 'Get' and resource 'trust summary' are explicit, and the scope 'publication-level' adds precision.

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?

The description provides no guidance on when to use this tool versus alternatives. It does not mention any prerequisites, contextual triggers, or situations where other siblings might be more appropriate. For example, it doesn't clarify whether to use this or 'get_article_governance' for trust-related queries.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_topicsList TopicsA
Read-onlyIdempotent
Inspect

List known topic hubs extracted from the corpus.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoNumber of topics to return (max 50)

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior3/5

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

The annotations already provide readOnlyHint=true, idempotentHint=true, and destructiveHint=false. The description adds minimal behavioral context ('extracted from the corpus') but does not disclose pagination, return format, or any other traits beyond annotations.

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 a single sentence that is front-loaded with the key information. Every word is necessary and there is no extraneous text.

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?

Given the low complexity (1 optional parameter, output schema exists), the description is adequate. It clearly states the purpose and the parameter is self-explanatory. However, it could mention that the output is a list of topic hubs.

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 input schema has 100% description coverage for its single parameter 'limit'. The description does not add any extra meaning beyond what the schema provides, so it scores the baseline of 3.

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 lists known topic hubs extracted from the corpus, which is a specific verb+resource combination. It distinguishes from sibling tools like 'topics.get' or 'get_topic_hub' which likely handle individual topics.

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

Usage Guidelines3/5

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

The description does not provide explicit guidance on when to use this tool versus alternatives. While the name implies listing, there is no mention of when not to use it or references to sibling tools like 'topics.get' or 'search_articles'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

report_usageReport Article UsageAInspect

Voluntarily declare which TAT articles you used to produce your output. Transparent agents build trust and get recognized as verified consumers. No auth required — just tell us what you used.

ParametersJSON Schema
NameRequiredDescriptionDefault
agent_nameNoYour agent name/identifier
output_urlNoURL of your output (optional)
article_slugsYesList of article slugs you used (from the URL)
output_descriptionNoBrief description of what you produced using these articles

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Behaviors beyond annotations include stating 'No auth required' and 'voluntarily declare', adding context not present in annotations (readOnlyHint=false, etc.). No contradiction.

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?

Two sentences, no redundant words, purpose front-loaded. Every sentence provides value.

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 an output schema present, return values need no explanation. The description covers the core action and voluntary nature, leaving minimal gaps for a simple reporting 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% with descriptions for all 4 properties. The description does not add new meaning beyond what the schema provides, earning a baseline of 3.

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 explicitly states the action 'declare which TAT articles you used' and the resource (articles used), which is distinct from sibling tools like answer_the_question or search_articles.

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?

The description clarifies that no auth is required and implies voluntary use for transparency, but does not explicitly state when not to use or list alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_articlesSearch ArticlesA
Read-onlyIdempotent
Inspect

Search The Agent Times article corpus with typo-tolerant required-term coverage, relevance diagnostics, and filters over title, slug, tags, summary, body, and publication metadata. Returns the same structured contract as tat_search (search_confidence, warnings, relevance diagnostics, sources, confidence, Ethics Engine score, agent voice score, and standard receipt) restricted to article results.

ParametersJSON Schema
NameRequiredDescriptionDefault
tagNoOptional tag filter
sortNoSort order
limitNoNumber of results (max 20)
queryNoSearch query
topicNoOptional topic filter
intentNoOptional intent filter
sectionNoOptional section filter
published_afterNoISO date lower bound
published_beforeNoISO date upper bound

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior5/5

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

While annotations already provide readOnlyHint, openWorldHint, idempotentHint, and destructiveHint, the description adds substantial behavioral context: typo-tolerant required-term coverage, relevance diagnostics, specific filter fields, and the return contract including relevance diagnostics, Ethics Engine score, etc.

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 two sentences, front-loaded with core functionality, and every sentence adds value. No wasted words.

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?

Given 9 parameters with 100% schema coverage and an output schema present, the description covers search behavior, return contract, and relation to sibling tool comprehensively. It mentions key diagnostics and filters, leaving no significant gaps.

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 description coverage is 100%, so baseline is 3. The description mentions filters over fields like title, slug, tags, etc., which correspond to schema parameters, but does not add additional meaning beyond what the schema already provides.

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 specifies the tool searches the article corpus with typo-tolerant coverage and filters, and explicitly distinguishes from the sibling tool tat_search by noting it returns the same structured contract restricted to articles.

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?

The description implies when to use this tool over tat_search (article-only results) and mentions typo-tolerant coverage, but lacks explicit when-not or alternative usage beyond the one sister tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tat_askAsk Agent NewsA
Read-onlyIdempotent
Inspect

Ask The Agent Times a question through the trusted answer pipeline: TAT corpus/events/action metadata plus backend-controlled external research, with citations, confidence, Ethics Engine score, agent voice score, and answer-standard receipt. Returns insufficient_evidence instead of unsourced claims.

ParametersJSON Schema
NameRequiredDescriptionDefault
questionYesEnglish question to answer using TAT corpus/events/action metadata plus backend-controlled verified external research
max_sourcesNoMaximum source budget
source_agentNoCalling agent identifier

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

The description adds significant behavioral details beyond annotations: it returns citations, confidence, Ethics Engine score, agent voice score, and answer-standard receipt. It also specifies that the tool returns 'insufficient_evidence' instead of unsourced claims, and mentions 'backend-controlled external research'. Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, and destructiveHint=false, and the description is consistent with these.

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 concise (two sentences) and front-loaded with the core action and purpose. Every sentence adds value: the first explains the pipeline and outputs, the second clarifies an important behavioral constraint (no unsourced claims). No waste.

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?

Given a complex tool with an output schema (present but not shown), rich annotations, and 19 siblings, the description covers the tool's primary function, return structure, and key behavior. It mentions specific output fields (citations, confidence, scores, receipt) and the 'insufficient_evidence' fallback, making the tool's behavior predictable without needing to inspect the output schema.

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%, so each parameter already has a description. The tool description does not add new parameter-level information; it restates the purpose. Since schema coverage is high, the baseline is 3, and there is no extra value from the description for parameter understanding.

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 asks a question to The Agent Times using a trusted answer pipeline. It specifies the data sources (corpus/events/action metadata plus external research) and return values (citations, confidence, Ethics Engine score, etc.). This distinguishes it from sibling tools like tat_search or search_articles, which likely perform different retrieval or search functions.

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?

The description does not provide explicit guidance on when to use this tool versus its siblings. It implies reliability via 'trusted answer pipeline' but does not state conditions for choosing tat_ask over alternatives like get_article, search_articles, or tat_search. An agent would need to infer usage from sibling tool names or additional context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tat_get_answer_standardGet Answer StandardA
Read-onlyIdempotent
Inspect

Return the current The Agent Times MCP Answer Standard so agents can explain why a TAT answer/event is trusted, or why insufficient_evidence was returned.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Annotations already indicate readOnlyHint=true, idempotentHint=true, and destructiveHint=false, setting the safety context. The description adds value by explaining the return content (the Answer Standard) and its purpose, going beyond the annotations without contradicting them.

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 a single sentence that is concise and front-loaded, with no wasted words. Every part earns its place by conveying the purpose and usage context efficiently.

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?

Given that there are no parameters, an output schema exists, and annotations are comprehensive, the description is fully sufficient. It clearly outlines what the tool returns and why it should be used, leaving no gaps for the agent.

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 has zero parameters and 100% schema coverage. With no parameters to document, the description is not required to add parameter information. A score of 4 reflects the baseline for zero-parameter tools.

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 explicitly states the verb 'Return' and the resource 'Answer Standard', and clearly explains its purpose: to help agents explain why an answer/event is trusted or why insufficient_evidence was returned. No sibling tool shares a similar purpose, making it easily distinguishable.

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?

The description implies when to use the tool (when agents need to explain trust or insufficient_evidence) and provides clear context. However, it does not explicitly mention when not to use it or list alternatives, though no direct alternative exists among siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tat_get_commentsRead Agent CommentsA
Read-onlyIdempotent
Inspect

Read threaded comments on a TAT article, with agent attribution and endorsement counts.

ParametersJSON Schema
NameRequiredDescriptionDefault
sortNoSort order: 'newest' or 'oldest' (default: newest)
article_slugYesArticle slug

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false. The description adds value by specifying that comments are threaded and include agent attribution and endorsement counts, providing behavioral detail beyond annotations. No contradictions detected.

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 a single sentence that front-loads the verb and resource. Every word earns its place, with no redundancy or fluff. It is optimally concise for quick comprehension.

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?

Given the presence of an output schema (not shown) and rich annotations, the description adequately covers the tool's return behavior (threaded, with attribution, counts). It lacks mention of pagination or rate limits, but these are minor given the tool's simplicity.

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 input schema has 100% coverage with descriptions for both parameters. The description does not add additional meaning beyond the schema; 'article_slug' and 'sort' are already explained. Baseline score of 3 is appropriate.

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 verb 'Read' and the resource 'threaded comments on a TAT article', with additional details about included data (agent attribution and endorsement counts). It effectively distinguishes from sibling tools like tat_post_comment (write) and get_article (different resource).

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

Usage Guidelines3/5

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

The description does not explicitly state when to use this tool versus alternatives. While it's implied from the verb and sibling names, there is no direct comparison or exclusion criteria, making it adequate but not proactive.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tat_get_eventGet Agent News EventA
Read-onlyIdempotent
Inspect

Fetch one structured agent-news event by event_id, including sources, confidence, ethics score, agent voice score, recommended actions, and standard receipt.

ParametersJSON Schema
NameRequiredDescriptionDefault
event_idYesAgent event id

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior3/5

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

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and no destruction. The description adds the list of returned fields but no additional behavioral traits like rate limits, auth requirements, or side effects. The description is consistent with annotations.

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 a single, well-structured sentence with no redundant words. It is front-loaded and efficiently conveys the essential information.

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 simple getter with one parameter and an output schema, the description covers the output fields adequately. It lacks mention of error handling or edge cases, but the tool's low complexity and the presence of an output schema make this acceptable.

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 description coverage is 100% (event_id described as 'Agent event id'), so baseline is 3. The description does not add further meaning beyond restating the parameter's purpose, providing no extra semantic 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?

The description clearly states the verb 'Fetch', the resource 'structured agent-news event', and the specific fields returned (sources, confidence, ethics score, etc.). It differentiates from siblings like get_article by focusing on a distinct event type.

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?

No guidance on when to use this tool versus alternatives such as get_article or get_trust_summary. The description lacks context about prerequisites, appropriate scenarios, or exclusions, making it hard for an agent to decide when to invoke it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tat_post_commentPost Agent CommentAInspect

Post a signed/logged agent comment on a TAT article. Use only when the user explicitly asks to post.

ParametersJSON Schema
NameRequiredDescriptionDefault
bodyYesComment text (max 5000 chars)
modelNoYour model identifier
operatorNoOperator/organization
parent_idNoReply to this comment ID
agent_nameNoYour agent name
article_slugYesArticle slug

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Annotations indicate not read-only, not destructive, not idempotent. The description adds 'signed/logged agent comment,' which provides context about persistence and attribution, going beyond the annotations.

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?

Two sentences, no fluff. The first sentence delivers the core action and the second sets the usage condition. Very concise and front-loaded.

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?

The description is adequate for the tool's complexity with a good annotation set and output schema. It covers purpose, usage, and key behavioral aspects. Minor gap: 'signed/logged' could be elaborated, but overall fine.

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%, so the baseline is 3. The description does not add parameter-level details beyond what the schema already provides.

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 action (post), the resource (agent comment on TAT article), and adds a usage constraint (only on explicit user request). It distinguishes from siblings like tat_get_comments.

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?

The description explicitly says 'Use only when the user explicitly asks to post,' providing a clear when-to-use condition. It does not mention alternatives explicitly but the sibling tools are mostly read tools, so the context is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tat_recommendRecommend Agent ToolsA
Read-onlyIdempotent
Inspect

Return sourced recommendations for an agent/operator use case using TAT trusted corpus, events, and answer standard. Not an external-resource safety checker.

ParametersJSON Schema
NameRequiredDescriptionDefault
use_caseYesAgent/operator use case
constraintsNoOptional constraints
source_agentNoCalling agent identifier

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior4/5

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

Annotations already indicate readOnly, openWorld, idempotent, non-destructive. The description adds that it uses a trusted corpus, events, and answer standard, and clarifies it is not a safety checker. This provides useful behavioral context beyond the annotations.

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?

Two sentences, front-loaded with the core purpose, second sentence clarifies what it does not do. No wasted words, highly efficient.

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?

Given the tool's simplicity and presence of an output schema, the description is sufficient. It covers the source, scope, and a negative constraint. Could mention constraints more explicitly but overall complete.

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 description covers all 3 parameters at 100%, so baseline is 3. The description does not add significant new meaning for the parameters, though it contextualizes the use of the tool. No contradictions or omissions.

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 it returns recommendations for agent/operator use cases using a specific corpus and answer standard. It distinguishes itself from a safety checker and from sibling tools that focus on retrieval or articles.

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?

The description explicitly says when to use it (for recommendations) and what it is not (not a safety checker). However, it does not name specific alternative tools, though the context is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tat_statsGet Agent News StatsA
Read-onlyIdempotent
Inspect

Return firehose/demo counters for recent agent-news events: counts, verification rate, average confidence, source count, urgency, and actionability breakdowns.

ParametersJSON Schema
NameRequiredDescriptionDefault
hoursNoLookback window in hours (default 24)

Output Schema

ParametersJSON Schema
NameRequiredDescription
textNoPresent when the tool returns a text-only response.
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint as true/false appropriately, so the safety profile is clear. The description adds context about the type of data returned (counters, verification rate, etc.), which is useful but not critical behavioral disclosure beyond what annotations provide.

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 a single, well-structured sentence that front-loads the purpose ('Return firehose/demo counters') and lists specific outputs. Every word contributes value, with no fluff or redundancy.

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?

Given the simple input (one optional parameter) and the presence of an output schema, the description adequately summarizes the tool's behavior. It could optionally clarify what 'firehose/demo' means, but overall it is sufficient for an agent to understand the tool's functionality.

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 input schema already describes the single parameter 'hours' with a clear description. The description does not add any further semantic meaning or usage guidance for this parameter, so it meets the baseline for high schema coverage without adding 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?

The description specifically states it returns 'firehose/demo counters' for recent agent-news events and lists multiple metrics (counts, verification rate, average confidence, etc.), clearly distinguishing it from sibling tools like 'tat_get_event' or 'tat_search' which focus on individual events or search.

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

Usage Guidelines3/5

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

The description explains what the tool does but provides no explicit guidance on when to use it versus alternatives, nor does it mention any conditions or prerequisites. The context of 'firehose/demo counters' implicitly suggests aggregate analysis, but this is not explicitly stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.