Skip to main content
Glama

Faro Data — federal contracts, stock DNA, dips, IPOs

Everything the Faro knows about one stock

stock_profile
Read-onlyIdempotent

One call: DNA score and pillars, federal contracts of the last 60 days, contract-size stats, price vs 52-week high, long-term returns and IPO data when applicable. Costs 1 credit (free tier: 25 calls/day).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "ticker": "<ticker>"
    },
    "name": "stock_profile"
  }
}

Input Schema

NameRequiredDescriptionDefault
langNoLanguage of descriptions.
tickerYesStock ticker, e.g. RKLB.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, closed-world and non-destructive, so the safety profile is covered. The description adds context the annotations cannot: the per-call credit price and the free-tier daily quota, plus the conditional nature of IPO data ("when applicable"). Data freshness and empty-result behavior remain undisclosed.

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?

One dense sentence enumerating outputs, followed by a short cost/quota sentence. Nothing is wasted, and the "One call:" opener front-loads the aggregate value proposition.

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 flat parameters and no output schema, the enumeration of returned sections effectively substitutes for a return-value description, so an agent knows what it gets. Gaps are minor: no note on data freshness, caching, or what happens when a ticker has no contracts or no IPO.

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 both the ticker example (RKLB) and the lang enum documented inline, so the schema carries the parameter burden. The description adds no ticker format rules, exchange-prefix conventions, or statement of what lang actually localizes. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific composite resource and enumerates exactly what is bundled: DNA score and pillars, 60-day federal contracts, contract-size stats, price vs 52-week high, long-term returns and IPO data. "One call" implies the aggregate-snapshot role versus the narrower siblings (stock_dna, federal_contracts, ipo_radar), though no sibling is named explicitly.

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?

Usage is only implied: it is the one-shot profile rather than a targeted lookup, and the credit cost (1 credit, 25 free calls/day) gives a budget signal for choosing it over multiple targeted calls. There is no explicit "use this instead of X when Y" guidance, which matters given six overlapping siblings.

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