pulsenetwork-mcp
The PulseNetwork MCP Server provides access to 68 AI-powered intelligence verticals with 660+ endpoints, all paid autonomously via USDC on Base using the x402 protocol — no API keys or subscriptions required ($0.015–$1.00 per query).
Key verticals include:
Financial & Markets — Forex/macro data, trading signals, SEC filings, arbitrage scanning, DeFi/onchain intelligence, personal wealth management, economic indicators
Crypto & Blockchain — DeFi yield, wallet security, exchange comparison, crypto tax, RWA tokenization, onchain compliance
Legal & Compliance — Contract review, tenant/employment law, KYC/AML, data privacy, legislative tracking, IP/patent search, trade/tariff intelligence
Healthcare & Wellness — Medical procedure pricing, Medicare/elder care, nutrition research, fitness plans, mental health, pet health, herbal medicine, longevity protocols, clinical trial intelligence
Real Estate & Housing — Mortgage analysis, rent vs. buy, market trends, home maintenance/improvement ROI, construction estimates
Immigration & Travel — Visa requirements, PR pathways, digital nomad visas, theme park wait times, trip planning, live transit, city comparisons, travel safety/risk
Career & Education — Salary benchmarking, skills gap analysis, exam prep (NCLEX/CPA/LSAT), scholarship/FAFSA guidance, workforce intelligence
Sustainability & Environment — ESG/CSRD compliance, carbon disclosures, climate/weather forecasts, precision agriculture, energy/water intelligence
Sports & Betting — Sportsbook consensus, injury reports, matchup analysis, soccer betting, horse/greyhound racing, prediction markets
Consumer & Lifestyle — Deal/coupon discovery, product recommendations, meal planning, gaming deals, collectibles valuation, automotive recalls/repair
Government & Public Data — Federal contracts, grant discovery, FOIA records, veterans benefits, product safety recalls, historical newspaper archives
Business & Investment — Franchise FDD analysis, VC/startup funding data, cybersecurity threat intel, geopolitical risk, remittance rates, insurance comparisons
Standout features:
discovertool — Find relevant verticals for any task by categorySingle integration — One MCP server replaces dozens of APIs; agents discover and pay autonomously
Multilingual — All verticals support 20+ languages
Compatible with Claude Desktop, Cursor, Windsurf, and any MCP client
PulseNetwork MCP Server
73 AI-powered intelligence verticals — 851 endpoints. One integration. Pay-per-query via x402 on Base.
PulseNetwork is the most comprehensive x402-native intelligence network available. Add one block to your Claude Desktop config and your agent gains access to 73 domain-specific intelligence APIs (851 endpoints) — finance, legal, healthcare, immigration, real estate, crypto, careers, travel, sustainability, sports/prediction markets, and more — all paying autonomously via USDC on Base.
No API keys. No subscriptions. Agents pay per query, $0.015–$1.00 each.
Quick Start
1. Install
npm install -g mcp-pulsenetworkOr use without installing:
npx mcp-pulsenetwork2. Get a Base wallet with USDC
You need a wallet with USDC on Base mainnet. Options:
Coinbase Wallet — easiest, direct Base support
Rainbow Wallet — works great
Any EVM wallet — bridge USDC to Base via bridge.base.org
Export your private key from the wallet settings.
3. Add to Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"pulsenetwork": {
"command": "npx",
"args": ["-y", "mcp-pulsenetwork"],
"env": {
"AGENT_PRIVATE_KEY": "0xYourWalletPrivateKeyHere"
}
}
}
}Restart Claude Desktop. You now have 73 intelligence verticals available.
4. Add to Cursor / Windsurf / any MCP client
Same config pattern — point command at npx and pass your key via env.
Related MCP server: aipaygen-mcp
What's Included
Vertical | What It Does | Price |
macropulse | Forex/macro: COT reports, Fed policy, inflation, currency analysis | $0.10 |
immigrationpulse | Visa requirements, PR pathways, nomad visas, citizenship, USCIS status | $0.10–$0.20 |
legalpulse | Contracts, tenant rights, business formation, employment law | $0.10 |
wealthpulse | Retirement projections, debt strategy, credit card optimization | $0.10–$0.15 |
careerpulse | Salary benchmarks, negotiation strategy, skills gap, job outlook | $0.10 |
cryptopulse | DeFi yield, wallet security, crypto tax by jurisdiction | $0.08–$0.10 |
esgpulse | ESG ratings, CSRD compliance, carbon disclosures, EU taxonomy | $0.10–$0.15 |
riskpulse | Country risk scores, travel advisories, geopolitical monitoring | $0.08–$0.10 |
taxpulse | Tax rates by country, nomad optimization, crypto treatment | $0.08–$0.15 |
proppulse | Mortgage rates, affordability, rent vs buy, market trends | $0.08–$0.10 |
patentpulse | USPTO search, pharma patent cliffs, FTO analysis | $0.08–$0.15 |
seniorpulse | Medicare comparisons, care facility assessment, benefits eligibility | $0.10–$0.15 |
clearcarepulse | Hospital procedure costs, Medicare benchmarks, bill negotiation | $0.08–$0.10 |
tradepulse | Tariffs, trade agreements, supply chain risk | $0.05–$0.10 |
filingspulse | SEC 10-K/10-Q/8-K summaries, risk factors, insider trades | $0.10 |
transitpulse | Live transit alerts, city comparisons, car-free livability | $0.05–$0.12 |
travelpulse | Theme park wait times globally, crowd prediction, trip planning | $0.05–$0.20 |
climatepulse | Forecasts for any location on Earth, extreme weather analysis | $0.05–$0.10 |
debtpulse | Debt payoff strategies, negotiation scripts, collector rights | $0.08–$0.10 |
edupulse | K-12 study guides, NCLEX/CPA/LSAT/Bar exam prep | $0.05–$0.15 |
nutripulse | PubMed nutrition synthesis, supplement evidence | $0.05–$0.10 |
fitpulse | Custom training programs, workout plans, recovery science | $0.05–$0.15 |
mindpulse | Therapy matching, coping techniques, burnout assessment | $0.08–$0.10 |
petpulse | Pet symptom triage, nutrition, medication safety | $0.08–$0.10 |
herbapulse | Herb profiles, drug interactions, traditional medicine | $0.08–$0.10 |
parentpulse | Child milestones, pediatric health triage, childcare options | $0.05–$0.10 |
autopulse | Vehicle recalls, common problems, DIY repair guides | $0.05–$0.10 |
homepulse | Materials lists, how-to guides, permit requirements | $0.08–$0.10 |
buildpulse | Construction estimates, permits, contractor vetting, ROI | $0.08–$0.10 |
insurepulse | Insurance carrier comparisons, coverage gap analysis | $0.08–$0.15 |
alphapulse | Stock earnings analysis, analyst sentiment, insider activity | $0.10 |
marketpulse | Sector rotation, sentiment indicators, weekly market briefs | $0.08 |
onchainpulse | Onchain finance intelligence + flagship pre-trade token-safety scanners: Solana memecoin ( | $0.015–$0.10 |
signalpulse | Institutional-grade trading & prediction-market intelligence: sports/fantasy analysis, de-vigged sportsbook consensus, Polymarket/Kalshi/Manifold/PredictIt edges, racing, crypto/FX/macro scans; free daily sample | $0.50–$1.00 |
biopulse | Species occurrence, birding intelligence (1B+ eBird records) | $0.05–$0.08 |
safepulse | CPSC/FDA/NHTSA recalls across all consumer product categories | $0.05–$0.08 |
chronicapulse | Library of Congress: 30M+ historical newspaper pages 1770–1963 | $0.08–$0.10 |
grantpulse | Open grants for nonprofits, startups, researchers (global) | $0.08–$0.10 |
remittancepulse | Best rates and fees for any global money transfer corridor | $0.05–$0.08 |
compliancepulse | Regulatory changes, filing deadlines, gap analysis | $0.08–$0.15 |
policypulse | Federal/state bills, regulatory changes, impact analysis | $0.05–$0.10 |
franchisepulse | FDD analysis, franchise costs, earnings claims | $0.10–$0.15 |
gridpulse | Electricity prices, grid stress, solar potential, EV infrastructure | $0.08–$0.10 |
harvestpulse | Seasonal produce, farmers markets, CSA programs (global) | $0.05–$0.08 |
findpulse | Secondhand market search, underpriced listing detection | $0.08–$0.10 |
dealpulse | Real-time coupons, price comparisons, sale event intelligence | $0.05–$0.10 |
mealpulse | Complete meal plans with recipes, grocery prices, shopping lists | $0.08–$0.20 |
gamepulse | Game deals, meta analysis, esports data, trading card prices | $0.05–$0.10 |
statedge | Sports betting lines, player props, injury reports, fantasy waiver | $0.08–$0.10 |
fanpulse | Fandom lore, character profiles, trivia (K-pop, Bollywood, anime, global) | $0.08 |
collectablespulse | Trading card/memorabilia prices from eBay sold history | $0.08–$0.15 |
vetpulse | VA benefits, disability ratings, GI Bill, healthcare enrollment | $0.05–$0.10 |
Example Usage
Once connected to Claude Desktop, just ask naturally:
"What's the best path for an Indian software engineer on H-1B to get a green card?"
Claude will call immigrationpulse → pathway action automatically.
"Compare ESG scores for Tesla, Exxon, and Apple"
Claude calls esgpulse → benchmark for each.
"What's in season in the UK right now and find me a farmers market near London?"
Claude calls harvestpulse → season and find.
"I have $40k in credit card debt across 4 cards. What's my best payoff strategy?"
Claude calls debtpulse → payoff with your details.
Language Support
Every vertical supports the lang parameter. Ask Claude to respond in any language:
"Explain digital nomad visa options for Brazil — respond in Portuguese"
Supported: en es fr de zh hi ar pt ja ko it ru nl sv pl tr vi id th tl bn ur sw
The discover Tool
Not sure which vertical to use? Ask Claude:
"What PulseNetwork verticals cover sustainability?"
Claude calls discover with category: data and returns the relevant options.
Payment Details
Network: Base mainnet (
eip155:8453)Token: USDC (
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)Protocol: x402 — open standard by the Linux Foundation
Price range: $0.015–$1.00 per query
No subscription, no API key — agents pay autonomously per request
For Developers / Agent Builders
This is infrastructure. Build agents on top:
Immigration agent — monitors visa bulletin, alerts when priority dates move
Portfolio agent — queries MacroPulse + FilingsPulse + AlphaPulse on a schedule
Compliance agent — monitors CompliancePulse weekly, surfaces relevant rule changes
Relocation agent — combines ImmigrationPulse + TransitPulse + RiskPulse + TaxPulse
Each agent builds on PulseNetwork as the intelligence layer, paying per query, running autonomously.
Agent Skill (npx skills)
PulseNetwork ships as an installable agent skill — one artifact that teaches Claude Code, Cursor, and Bankr agents how to discover and pay PulseNetwork endpoints (via MCP or direct x402 HTTP).
npx skills add github.com/GTCC777/mcp-pulsenetworkThe skill lives at skills/pulsenetwork/SKILL.md.
Built On
x402 Protocol — open payment standard for AI agents
Base — Coinbase L2, fast and cheap USDC settlement
Anthropic Claude — synthesis layer for all verticals
Model Context Protocol — agent integration standard
License
MIT © The Aslan Group LLC
Available Tools
69 toolsalphapulseCInspect
AlphaPulse: Global alternative trading intelligence API. AI-synthesized signal provider rankings, managed account analysis, copy trading discovery, expert advisor (EA/robot) vetting, multi-asset arbitrage, crypto
Coverage: Global
Endpoints: • discover ($0.15): Cross-platform provider discovery • signals ($0.10): Signal provider discovery • ea ($0.10): Expert Advisor discovery • copy ($0.10): Copy trading discovery • managed ($0.10): Managed account discovery • vaults ($0.08): DeFi vault discovery • vet ($0.15): Provider due diligence • broker ($0.10): IB-approved broker recommendation • asia ($0.08): Asia-Pacific copy trading discovery • alternative ($0.08): Alternative and niche strategies • compare ($0.10): Side-by-side provider comparison
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | lang | |
| type | No | signal|copy|EA|managed|vault|any | |
| action | Yes | Which endpoint to call. Options: discover | signals | ea | copy | managed | vaults | vet | broker | asia | alternative | compare | |
| region | No | region | |
| min_tvl | No | min_tvl | |
| category | No | category | |
| platform | No | platform | |
| protocol | No | protocol | |
| provider | No | provider | |
| strategy | No | strategy | |
| use_case | No | use_case | |
| min_weeks | No | min_weeks | |
| providers | No | Comma-separated provider names (min 2) | |
| instrument | No | instrument | |
| min_return | No | min_return | |
| min_copiers | No | min_copiers | |
| max_drawdown | No | max_drawdown | |
| us_accessible | No | us_accessible | |
| min_investment | No | min_investment | |
| min_track_record | No | min_track_record |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided; description carries full burden. It mentions pricing per endpoint and global coverage but does not disclose error behavior, rate limits, authentication needs, or read-only nature.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is lengthy with a bullet list of endpoints and prices. It is somewhat structured but contains redundancy (e.g., 'Coverage: Global') and could be more concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema and 20 parameters, the description does not explain what the tool returns or how parameters like 'min_tvl' filter results. It is incomplete for effective tool selection.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with parameter descriptions, but those descriptions are minimal (e.g., 'lang' is just 'lang'). The tool description adds context for the 'action' parameter listing endpoints, but other parameters lack additional meaning beyond names.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a global alternative trading intelligence API with multiple endpoints (discover, signals, ea, etc.), distinguishing it from sibling 'pulse' tools by specifying its domain.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 other 'pulse' tools. It lists endpoints but does not provide criteria for selection or when to avoid.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
arbipulseCInspect
ArbiPulse: 12 endpoints scanning arbitrage opportunities across DeFi yield spreads, DEX price differentials, perpetual funding rates, sports surebets, ETF/NAV gaps, and commodity regional pricing. Execution-tier
Coverage: Global
Endpoints: • scanner ($0.10): Unified Arbitrage Scanner • defi ($0.10): DeFi Yield Arbitrage • perps ($0.10): Perpetual Futures Funding Rate Carry • flash ($0.75): Flash Loan Strategy Builder • sports ($0.10): Sports Surebet Scanner • crypto ($0.07): CEX Spot Price Arbitrage • dex ($0.10): DEX Price Arbitrage • execute ($0.75): Execution Package Builder • calculator ($0.05): Arbitrage Profit Calculator • etf ($0.10): ETF/NAV Premium-Discount Tracker • commodity ($0.10): Commodity Regional Arbitrage • pairs ($0.15): Statistical Arbitrage (Pairs Trading)
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | days | |
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| pair | No | pair | |
| type | No | type | |
| unit | No | unit | |
| asset | No | asset | |
| chain | No | chain | |
| sport | No | sport | |
| token | No | token | |
| action | Yes | Which endpoint to call. Options: scanner | defi | perps | flash | sports | crypto | dex | execute | calculator | etf | commodity | pairs | |
| amount | No | amount | |
| chains | No | chains | |
| region | No | region | |
| ticker | No | ticker | |
| asset_a | No | asset_a | |
| asset_b | No | asset_b | |
| gas_usd | No | gas_usd | |
| min_apy | No | min_apy | |
| regions | No | regions | |
| arb_type | No | arb_type | |
| category | No | category | |
| platform | No | platform | |
| protocol | No | protocol | |
| receiver | No | receiver | |
| strategy | No | strategy | |
| commodity | No | commodity | |
| exchanges | No | exchanges | |
| amount_usd | No | amount_usd | |
| exit_price | No | exit_price | |
| long_venue | No | long_venue | |
| asset_class | No | asset_class | |
| entry_price | No | entry_price | |
| short_venue | No | short_venue | |
| slippage_bps | No | slippage_bps | |
| flash_fee_bps | No | flash_fee_bps | |
| lookback_days | No | lookback_days | |
| taker_fee_bps | No | taker_fee_bps | |
| bridge_fee_usd | No | bridge_fee_usd | |
| min_profit_pct | No | min_profit_pct | |
| min_profit_usd | No | Minimum net profit per $1,000 stake | |
| min_spread_bps | No | min_spread_bps | |
| trade_size_usd | No | trade_size_usd | |
| wallet_address | No | wallet_address | |
| stablecoin_only | No | stablecoin_only | |
| opportunity_type | No | opportunity_type | |
| withdrawal_fee_usd | No | withdrawal_fee_usd |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It does not disclose behavioral traits such as auth requirements, rate limits, or side effects. The 'Execution-tier' hint is vague about costs but insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is structured as a list of endpoints with prices, which is clear but verbose. It front-loads the purpose, but the endpoint list could be condensed or supplemented with usage examples.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 46 parameters and 12 endpoints without output schema or mapping from params to actions, the description is incomplete. It does not explain how to construct valid requests for specific endpoints.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is 100%, most parameter descriptions are tautological (e.g., 'days', 'pair') adding no meaning. Only 'action' and 'lang' have meaningful descriptions. The tool description does not compensate by mapping parameters to endpoints.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it scans arbitrage opportunities across multiple domains (DeFi, DEX, perpetuals, sports, ETF, commodities). However, it does not differentiate from sibling tools like cryptopulse or alphapulse, which may also have similar structures.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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, no prerequisites, and no exclusions. The description only lists endpoints without context on selection criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
autopulseAInspect
AutoPulse: Automotive intelligence API — 10 endpoints powered by NHTSA, EPA, and live market data. Safety recalls, reliability analysis, DIY repair guides, vehicle comparison, market value, EV break-even, dealer
Coverage: Global
Endpoints: • recall ($0.05): NHTSA safety recall lookup • problems ($0.10): Known problems and reliability analysis • repair ($0.10): DIY repair guide • compare ($0.10): Vehicle comparison • value ($0.08): Market value estimate • ev-breakeven ($0.10): EV break-even analysis vs. gas vehicle • negotiate ($0.10): Car buying negotiation guide • inspect ($0.08): Pre-purchase inspection checklist • parts ($0.08): Parts pricing and sourcing • tco ($0.15): Total cost of ownership (5-year)
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | Repair job (e.g. brake-pads, oil-change, cabin-air-filter) | |
| vin | No | 17-character VIN | |
| lang | No | lang | |
| make | No | make | |
| part | No | Part name (e.g. brake-pads, alternator, water-pump) | |
| trim | No | trim | |
| year | No | year | |
| model | No | model | |
| state | No | US state for state-level incentives and electricity rates | |
| action | Yes | Which endpoint to call. Options: recall | problems | repair | compare | value | ev-breakeven | negotiate | inspect | parts | tco | |
| mileage | No | mileage | |
| vehicle | No | Vehicle descriptor (e.g. 2020-toyota-camry) | |
| ev_model | No | EV model name (e.g. Tesla Model 3, Chevrolet Bolt, Ford F-150 Lightning) | |
| vehicles | No | Comma-separated vehicles (e.g. Toyota RAV4,Honda CR-V,Mazda CX-5) | |
| condition | No | condition | |
| gas_price | No | Local gas price in $/gallon | |
| gas_vehicle | No | Gas vehicle for comparison (e.g. Toyota Camry, Honda CR-V) | |
| annual_miles | No | Annual mileage (default: 12,000) | |
| purchase_price | No | Purchase price in USD | |
| electricity_rate | No | Local electricity rate in $/kWh |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must convey behavioral traits. It discloses endpoint costs and global coverage but omits details on idempotency, rate limits, data freshness, or side effects. The listing of endpoints and costs offers moderate transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is verbose, including cost per call for each endpoint which is not essential for tool selection. It is structured with bullet points and front-loads key info (name, coverage), but could be more concise by omitting pricing details.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (20 parameters, 10 endpoints), the description provides a good overview of capabilities and parameter-action mapping. No output schema exists, but the endpoints are straightforward lookups. The description covers scope sufficiently, though response format is not mentioned.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with individual parameter descriptions. The description adds context by mapping endpoints (action enum) to use cases (e.g., recall for safety recalls). This helps understand which parameters apply to which actions, adding value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as an automotive intelligence API with 10 specific endpoints covering recalls, problems, repair, comparison, etc. It distinguishes from siblings by focusing on automotive data (NHTSA, EPA, market). However, the cost-per-call detail is extraneous for purpose clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists endpoints but does not explicitly state when to use autopulse over sibling pulse tools. The 'automotive' focus implies domain, but no direct comparison or exclusions are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
biopulseCInspect
BioPulse: Global biodiversity intelligence API. GBIF + IUCN + eBird + iNaturalist data synthesis. Species profiles, IUCN conservation status, sighting reports, birding hotspots, migration tracking, endangered s
Coverage: Global
Endpoints: • species ($0.12): Species profile • sightings ($0.08): Recent wildlife sightings • birding ($0.10): Birding intelligence • invasive ($0.08): Invasive species alerts • endangered ($0.10): Endangered species profile • hotspot ($0.10): Biodiversity hotspot guide • identify ($0.12): Species identification • migrate ($0.10): Migration intelligence • marine ($0.10): Marine biodiversity
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | lat | |
| lng | No | lng | |
| dist | No | Search radius in km (max 50, default 25) | |
| lang | No | lang | |
| group | No | bird | mammal | reptile | amphibian | insect | plant | other | |
| action | Yes | Which endpoint to call. Options: species | sightings | birding | invasive | endangered | hotspot | identify | migrate | marine | |
| radius | No | Radius in km (max 100, default 25) | |
| region | No | Country, state, province, or region name | |
| species | No | Common or scientific name | |
| location | No | location | |
| description | No | What you observed — size, color, behavior, habitat |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, placing the full burden on the description. It does not disclose data freshness, authentication requirements, rate limits, or effects of incorrect parameters. Endpoint costs are mentioned but are not behavioral.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description contains a clear first sentence but then includes cluttered formatting (prices, emojis, bullet list) and redundant coverage line. It could be more concise and front-loaded with essential information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 11 parameters, no output schema, and multiple endpoints, the description lacks guidance on parameter dependencies (e.g., which are needed for each action). It does not explain what each endpoint returns or how to choose between parameters like 'dist' and 'radius'.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
While schema coverage is 100%, many parameter descriptions are tautological (e.g., 'lat', 'lng', 'lang', 'location' just repeat the name). The tool description adds no additional context for these parameters. The 'action' enum is well-described, but overall parameter semantics are poor.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool provides a global biodiversity intelligence API synthesizing GBIF, IUCN, eBird, and iNaturalist data, and lists specific endpoints like species profiles, sightings, and conservation status. This distinguishes it from unrelated sibling tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 versus alternatives. The description lists many sibling tools but provides no criteria for selection. The intended use for biodiversity queries is implied but not spelled out.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
buildpulseCInspect
BuildPulse: BuildPulse — home construction and renovation intelligence: project cost estimates, contractor vetting, permit requirements, material pricing, ROI projections, and inspection checklists. US-focused wi
Coverage: Global
Endpoints: • code ($0.10): /api/build/code • compare ($0.10): /api/build/compare • contractor ($0.10): /api/build/contractor • estimate ($0.15): /api/build/estimate • inspect ($0.08): /api/build/inspect • materials ($0.10): /api/build/materials • permit ($0.08): /api/build/permit • roi ($0.10): BuildPulse project ROI analysis — resale value, rental income, payback period, and alternatives • schedule ($0.10): /api/build/schedule • subcontractor ($0.10): /api/build/subcontractor
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | zip | |
| city | No | city | |
| lang | No | lang | |
| sqft | No | sqft | |
| stage | No | stage | |
| start | No | start | |
| state | No | state | |
| trade | No | trade | |
| action | Yes | Which endpoint to call. Options: code | compare | contractor | estimate | inspect | materials | permit | roi | schedule | subcontractor | |
| budget | No | budget | |
| project | No | project | |
| quality | No | quality | |
| material | No | material | |
| projects | No | projects | |
| home_value | No | home_value |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description must disclose behavioral traits. It briefly mentions endpoints and per-call costs but does not state safety (e.g., read-only vs. mutating), authorization needs, rate limits, or side effects. The endpoint names suggest read operations, but explicit disclosure is missing.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is moderately concise but contains redundancy ('BuildPulse: BuildPulse') and an incomplete sentence ('US-focused wi'). The endpoint list with costs is informative but could be more compact. The structure front-loads the purpose but then becomes a flat list without grouping or hierarchy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (15 parameters, 10 actions, no output schema), the description is incomplete. It does not describe the return value format, how parameters interact with actions, or provide examples. The schema has no meaningful constraint descriptions, leaving agents uncertain about valid inputs.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 15 parameters, all with descriptions that are just the parameter name (e.g., 'zip', 'city'). The description does not explain their meaning, format, or how they relate to specific actions. While the action enum is listed, neither the schema nor the description clarifies which parameters are required or valid for each action.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description identifies the tool as 'home construction and renovation intelligence' and lists actionable endpoints (code, compare, contractor, etc.). This clearly distinguishes it from sibling 'pulse' tools in other domains. However, the initial phrase 'BuildPulse: BuildPulse' is redundant and the text is truncated ('US-focused wi'), slightly reducing clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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. The description lists endpoints but does not explain under what circumstances to choose a particular action or how to combine parameters. Sibling tools cover different domains (e.g., alphapulse, marketpulse), so domain alone is insufficient guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
careerpulseCInspect
CareerPulse: Global career intelligence API serving the world's 3.5 billion workers. 10 endpoints: salary benchmarking (any role + any country, sourced from BLS, OECD, ILO, Glassdoor, Levels.fyi), industry outlook
Coverage: Global
Endpoints: • salary ($0.10): Salary benchmarking — any role, any country, any experience level • outlook ($0.08): Industry job market outlook — growth, hiring trends, top employers by country • skills-gap ($0.10): Skills gap analysis — exact skills needed to reach your target role • resume ($0.10): ATS-optimized resume intelligence — keywords, format, and recruiter intel by role • negotiate ($0.10): Salary negotiation playbook — counter-offer strategy and exact scripts • transition ($0.10): Career transition roadmap — transferable skills analysis and step-by-step pivot plan • remote ($0.08): Remote work intelligence — best remote roles, companies, and cross-border setup • certify ($0.08): Certification roadmap — highest-ROI certs in order, with study resources • interview ($0.10): Interview preparation — questions, frameworks, and company research intel • layoff ($0.08): Layoff support — severance review, legal rights, benefits continuation, next steps
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | to | |
| yoe | No | Years of experience | |
| from | No | from | |
| lang | No | BCP-47 language code — response in any language | |
| role | No | role | |
| offer | No | Offer amount in local currency | |
| title | No | title | |
| action | Yes | Which endpoint to call. Options: salary | outlook | skills-gap | resume | negotiate | transition | remote | certify | interview | layoff | |
| sector | No | sector | |
| target | No | target | |
| tenure | No | Years at company — affects severance expectations and legal entitlements | |
| company | No | company | |
| country | No | Country for localized outlook — defaults to global | |
| current | No | current | |
| industry | No | industry | |
| location | No | City, region, or country — global coverage | |
| timeline | No | Desired transition timeline — e.g. 6 months, 1 year | |
| current_certs | No | Comma-separated existing certifications |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden. It mentions pricing per endpoint but does not disclose other behavioral traits such as authentication requirements, rate limits, data freshness, or what happens on invalid inputs.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is somewhat verbose, listing all endpoints with pricing, but it uses bullet points and front-loads the general purpose. It could be more concise by omitting redundant details, but it is structured enough for scanning.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has 18 parameters and 10 actions with no output schema, but the description does not provide usage patterns, examples, or expected responses. The parameter descriptions in the schema are minimal, and the description fails to compensate, leaving significant gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is 100%, many parameter descriptions are tautological (e.g., 'to', 'from', 'current'). The tool description does not add any further meaning or context for parameters, leaving the agent with minimal guidance beyond parameter names.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool is a 'Global career intelligence API' and lists 10 specific endpoints (salary, outlook, etc.), making the purpose well-defined. However, it does not differentiate from the many sibling 'pulse' tools, relying on the 'career' context.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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. The description lists endpoints but does not explain how to choose between them or give any usage conditions, exclusions, or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chronicapulseCInspect
ChronicaPulse: Global genealogy and historical archive intelligence API. Full-text search across Chronicling America (1770–1963 US newspapers), Library of Congress, Trove (Australia), British Newspaper Archive, Euro
Coverage: Global
Endpoints: • search ($0.05): Archive search • person ($0.12): Person research • obituary ($0.10): Obituary research • event ($0.08): Historical event coverage • place ($0.08): Place history • immigration ($0.12): Immigration research • military ($0.10): Military service research • business ($0.08): Business history • timeline ($0.15): Chronological timeline
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search query | |
| era | No | era | |
| lang | No | lang | |
| name | No | name | |
| type | No | type | |
| year | No | year | |
| event | No | event | |
| place | No | place | |
| state | No | state | |
| action | Yes | Which endpoint to call. Options: search | person | obituary | event | place | immigration | military | business | timeline | |
| origin | No | Country of origin | |
| subject | No | subject | |
| business | No | business | |
| conflict | No | Civil War | WWI | WWII | Korean War | Vietnam | |
| location | No | location | |
| year_end | No | year_end | |
| year_start | No | year_start | |
| destination | No | US destination city |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, and the description lacks behavioral details such as rate limits, authentication, or error handling. It only lists endpoints and pricing, not enough for safe invocation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is structured with a list of endpoints and pricing, but it is overly long and includes repetitive information. Could be more concise while retaining key details.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 18 parameters, 9 endpoints, no output schema, and no annotations, the description is incomplete. It fails to explain how to use endpoints, which parameters are required for each, or what the output looks like.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, but parameter descriptions are extremely brief (e.g., 'era', 'lang'). The tool description adds no additional meaning beyond the schema and does not map parameters to specific endpoints, leaving ambiguity.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it's a genealogy and historical archive intelligence API, listing specific archives and endpoints. However, it does not differentiate from the many sibling 'pulse' tools, which could cause confusion.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 versus alternatives. With 68 sibling tools, the description should clarify that this is for historical/genealogical searches and not for other domains.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
clearcarepulseAInspect
ClearCarePulse: Healthcare price transparency and cost navigation API. AI-synthesized procedure price search, cash-pay alternatives, hospital quality scoring, out-of-pocket estimation, insurance negotiation scripts,
Coverage: Global
Endpoints: • search ($0.15): Procedure price search • hospital ($0.10): Hospital price lookup • episode ($0.15): Total episode cost breakdown • oop ($0.15): Out-of-pocket cost calculator • alternatives ($0.10): Lower-cost care site alternatives • negotiate ($0.10): Medical bill negotiation guide • dental ($0.10): Dental cost intelligence • cosmetic ($0.10): Cosmetic procedure cost intelligence
| Name | Required | Description | Default |
|---|---|---|---|
| hsa | No | Has HSA (true/false) | |
| zip | No | Patient zip code for geographic search | |
| lang | No | Response language (e.g., 'Spanish') | |
| action | Yes | Which endpoint to call. Options: search | hospital | episode | oop | alternatives | negotiate | dental | cosmetic | |
| income | No | Annual income in USD (for charity care eligibility) | |
| radius | No | Search radius in miles | |
| insured | No | insured | |
| oop_max | No | Annual out-of-pocket maximum in USD | |
| hospital | No | Hospital name — e.g., 'Cleveland Clinic', 'Stanford Medical Center' | |
| location | No | City or region for geographic adjustment | |
| oop_spent | No | OOP already spent this year in USD | |
| plan_type | No | Plan type (Bronze, Silver, Gold, Platinum, employer) | |
| procedure | No | Procedure name in plain English — e.g., 'knee MRI', 'colonoscopy', 'hip replacement' | |
| deductible | No | Annual deductible in USD | |
| bill_amount | No | Bill amount in USD | |
| coinsurance | No | Patient coinsurance % (default: 20) | |
| has_insurance | No | has_insurance | |
| deductible_met | No | Deductible already met this year in USD | |
| procedure_cost | No | Known procedure cost in USD | |
| current_setting | No | Where currently scheduled (default: hospital outpatient) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses pricing per endpoint (e.g., '$0.15'), which is useful. However, it does not explain authentication, rate limits, data sources, or what happens on error. The behavior of each endpoint is only implied by its name (e.g., 'search', 'hospital'). Moderate transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is relatively concise, with a brief opening sentence followed by a clear bullet list of endpoints and costs. However, the opening sentence is a bit run-on and could be split. Overall, it is efficient and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has 20 parameters and 8 endpoints, but the description does not explain which parameters are required for each endpoint (e.g., 'procedure' needed for 'search', 'hospital' for 'hospital'). The schema alone, without per-endpoint guidance, leaves the agent to infer the correct parameter combinations, which is risky. Significant gaps for a complex tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% with each parameter having a concise description (e.g., 'zip': 'Patient zip code for geographic search'). The tool description does not add further parameter context beyond listing endpoints. Thus, the schema already provides adequate semantics, meeting the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a 'Healthcare price transparency and cost navigation API' and lists specific endpoints. This distinguishes it from sibling tools which have different domain topics, so an agent can easily identify it for healthcare cost queries.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for healthcare cost navigation, but does not explicitly state when to use this tool versus siblings (though domain is clear). Within the tool, it lists endpoints but provides no guidance on which endpoint to choose for a given task, relying on the agent to infer from endpoint names. Slight gap in actionable guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
climatepulseBInspect
ClimatePulse: Global climate and weather intelligence API. Open-Meteo real-time weather + AI synthesis. Severe weather assessment, air quality monitoring, wildfire smoke tracking, agricultural grow-day modeling, cl
Coverage: Global
Endpoints: • now ($0.05): Current conditions • forecast ($0.08): Multi-day forecast • activity ($0.10): Activity weather assessment • severe ($0.08): Severe weather and preparedness • compare ($0.10): Location climate comparison • air ($0.05): Real-time air quality + health risk assessment • smoke ($0.05): Wildfire smoke tracking and respiratory risk assessment • grow ($0.08): Agricultural grow-day modeling and frost date analysis • event ($0.08): Event weather suitability and planning assessment
| Name | Required | Description | Default |
|---|---|---|---|
| crop | No | Target crop or plant type | |
| date | No | date | |
| days | No | Number of days (1–7, default 7) | |
| lang | No | lang | |
| units | No | Defaults to imperial (°F, mph, inches) | |
| action | Yes | Which endpoint to call. Options: now | forecast | activity | severe | compare | air | smoke | grow | event | |
| purpose | No | Comparison purpose (e.g. vacation, relocation, sports) | |
| activity | No | activity | |
| location | No | City name or location (e.g. Denver, CO) | |
| locations | No | Comma-separated list of 2–4 locations (e.g. Miami,Seattle,Denver) | |
| event_type | No | event_type |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full weight. It discloses the API source (Open-Meteo), AI synthesis, and global coverage, but fails to mention key behaviors like authentication, rate limits, data freshness, error handling, or any side effects. The description is largely a list of endpoints with pricing, not behavioral traits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is reasonably structured with a clear intro, coverage note, and bulleted endpoints. However, it is somewhat verbose with pricing details that could be optional or placed elsewhere. Minor redundancy with the schema enum.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (11 parameters, 9 actions) and lack of output schema or annotations, the description is insufficient. It does not explain how to choose between endpoints, what responses look like, or error conditions. Users are left to infer from parameter names alone.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all parameters adequately. The description adds some context (pricing, global coverage) but no parameter-specific guidance beyond what the schema provides. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it's a global climate and weather intelligence API with specific endpoints, making the purpose evident. However, it does not distinguish from many sibling pulse tools (e.g., harvestpulse, waterpulse) that may have overlapping functionality.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for climate/weather queries but provides no explicit guidance on when to use this tool versus alternatives, nor does it suggest exclusions or prerequisites. The listed endpoints offer some context but lack situational recommendations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
clinicalintelpulseAInspect
ClinicalIntelPulse: Pharmaceutical pipeline and clinical trial intelligence API. Synthesizes 400,000+ registered trials from ClinicalTrials.gov with FDA OpenFDA, PubMed, and real-time news. All endpoints require x402 pay
Coverage: Global
Endpoints: • pipeline-scan ($0.15): Phase 2/3 pipeline scan • approval-outlook ($0.25): FDA/EMA approval probability • sponsor-intel ($0.20): Pharma/biotech pipeline intelligence • disease-landscape ($0.35): Full disease landscape report • trial-brief ($0.10): Clinical trial deep dive by NCT ID • mechanism-map ($0.20): Drug target and MOA landscape • global-trials ($0.15): Global clinical trial landscape • failure-analysis ($0.20): Clinical trial failure analysis • patient-finder ($0.10): Recruiting trial finder (plain language) • deal-signal ($0.35): Biotech M&A and licensing deal signals
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Response language | |
| depth | No | depth | |
| focus | No | focus | |
| phase | No | phase | |
| stage | No | stage | |
| action | Yes | Which endpoint to call. Options: pipeline-scan | approval-outlook | sponsor-intel | disease-landscape | trial-brief | mechanism-map | global-trials | failure-analysis | patient-finder | deal-signal | |
| agency | No | agency | |
| nct_id | No | NCT identifier — e.g. NCT04368728 | |
| region | No | region | |
| status | No | status | |
| country | No | Optional country filter — e.g. 'United States' | 'Germany' | 'Australia' | |
| horizon | No | horizon | |
| sponsor | No | Company name — e.g. 'Moderna' | 'Alnylam' | 'Vertex Pharmaceuticals' | |
| condition | No | Disease or condition — e.g. 'Non-Small Cell Lung Cancer' | 'Alzheimer Disease' | 'Type 2 Diabetes' | |
| deal_type | No | deal_type | |
| mechanism | No | Optional focus — e.g. 'BTK inhibitor' | 'CAR-T' | 'IL-17' |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It discloses data sources (ClinicalTrials.gov, FDA OpenFDA, PubMed, real-time news) and endpoint pricing, which adds valuable context. However, it does not mention rate limits, authentication details, or whether operations are destructive, so some gaps remain.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is reasonably concise given the amount of information, starting with the core purpose and then listing endpoints. The list format makes it scannable. Minor redundancy (e.g., coverage mention) could be trimmed, but overall it is well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 16 parameters and no output schema, the description covers the high-level purpose and endpoint options but lacks guidance on how parameters combine or which parameters are relevant for each endpoint. It provides enough for simple use but misses deeper context needed for complex queries.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is 100%, many parameter descriptions are minimal (e.g., 'depth', 'focus', 'stage' are just the parameter name). The description does not elaborate on these generic parameters or clarify how they interact with different endpoints. While some parameters like nct_id and sponsor have examples in the schema, the description adds no extra meaning beyond what's in the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a 'Pharmaceutical pipeline and clinical trial intelligence API' and lists 10 specific endpoints with brief descriptions, making the tool's purpose immediately clear and distinguishing it from sibling tools that cover other domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides a list of endpoints with their intended uses (e.g., 'Phase 2/3 pipeline scan') and mentions a payment requirement ('All endpoints require x402 pay'). However, it does not explicitly state when not to use this tool or compare it to alternatives, which would be helpful given the many sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
collectablespulseBInspect
CollectablesPulse: Global collectibles market intelligence API. AI-synthesized valuations for sports cards, coins, comics, vinyl records, Pokémon/MTG/TCGs, sneakers, watches, signed memorabilia, and trading cards. Real-
Coverage: Global
Endpoints: • value ($0.10): Current market value by grade/condition • grade ($0.08): Grading service guide • authenticate ($0.10): Authentication guide — spot fakes, trusted services • invest ($0.15): Investment signal — buy/hold/sell with analysis • compare ($0.10): Head-to-head investment comparison • sell ($0.10): Where and how to sell for maximum value • storage ($0.08): Preservation and storage guide • insurance ($0.08): Collectibles insurance guide • population ($0.08): Population report and grade scarcity • provenance ($0.10): Provenance and ownership research • nft ($0.10): NFT contract safety & floor scan (on-chain GoPlus + market context)
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | Collectible description (e.g. '1952 Topps Mickey Mantle') | |
| lang | No | lang | |
| chain | No | ethereum | base | polygon | arbitrum | optimism | bsc | avalanche (default ethereum) | |
| grade | No | Grade or condition (e.g. 'PSA 10', 'CGC 9.8', 'raw Near Mint') | |
| item1 | No | item1 | |
| item2 | No | item2 | |
| action | Yes | Which endpoint to call. Options: value | grade | authenticate | invest | compare | sell | storage | insurance | population | provenance | nft | |
| service | No | Preferred service (PSA|BGS|CGC|PCGS|NGC|etc) | |
| contract | No | NFT contract address — enables the on-chain risk scan (recommended) | |
| collection | No | Collection name — for floor/sentiment context when no contract is known |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description must bear the burden. It mentions endpoints and costs, implying read-only queries, but does not explicitly state safety, failure modes, or side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with purpose, then a clear list of endpoints. Slightly verbose with repeated 'Collectibles' context, but well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Lacks explanation of return values, default behaviors, or how parameters interact across endpoints. With 10 parameters and no output schema, more context is needed for full usability.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers all parameters with descriptions (100% coverage). The description adds endpoint costs but does not significantly enhance parameter meaning beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a collectibles market intelligence API with specific categories (sports cards, coins, etc.) and lists distinct endpoints. This differentiates it from the many sibling 'pulse' tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool vs alternatives. With many similar sibling tools, explicit usage context is missing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
compliancepulseCInspect
CompliancePulse: Global regulatory intelligence API. 8 endpoints: data privacy law (145+ jurisdictions; privacy endpoint includes Cookiebot/OneTrust/Usercentrics consent tool links), KYC/AML requirements, corporate co
Coverage: Global
Endpoints: • privacy ($0.15): Data privacy law by jurisdiction • kyc ($0.12): KYC/AML requirements by jurisdiction • corporate ($0.15): Corporate compliance and entity setup • employment ($0.15): Employment law and HR compliance • sector ($0.15): Industry-specific regulatory compliance • cyber ($0.12): Cybersecurity compliance requirements • esg ($0.12): ESG and sustainability reporting requirements • news ($0.08): Regulatory intelligence and enforcement news
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | lang | |
| topic | No | privacy | kyc | corporate | employment | sector | cyber | esg | all | |
| action | Yes | Which endpoint to call. Options: privacy | kyc | corporate | employment | sector | cyber | esg | news | |
| listed | No | true | false — listed companies have additional disclosure requirements | |
| sector | No | fintech | banking | crypto | real-estate | legal | accounting | casino | |
| context | No | Business context — e.g. SaaS company, healthcare, e-commerce, fintech | |
| country | No | Country or jurisdiction — e.g. Germany, California, China, Brazil, Singapore. Also accepts 'jurisdiction' | |
| framework | No | NIS2 | DORA | NIST | ISO27001 | SOC2 | CMMC — or omit for country-based analysis | |
| entity_type | No | Entity type — e.g. Ltd, GmbH, BV, SAS, Pvt Ltd, LLC | |
| worker_type | No | contractor | employee | freelancer | gig — focus the classification risk analysis. Also accepts 'type' | |
| company_size | No | large | medium | small — determines which mandatory frameworks apply. Also accepts 'size' |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It fails to disclose behavioral traits such as read-only nature, authentication requirements, rate limits, or side effects. The only unusual detail is pricing, but it does not clarify if the tool fetches external data or what the return format is.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured but verbose, including marketing-like pricing and coverage information. It could be more concise by focusing on essential usage guidance. The length is acceptable but not optimally lean.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (11 parameters, no output schema, no annotations), the description is moderately complete. It lists endpoints and provides some context, but lacks guidance on parameter combinations, return values, or how to effectively use the tool beyond basic endpoint selection.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already documents each parameter. The tool description adds marginal value by listing endpoints and their purposes, which maps to the 'action' parameter, but it does not provide additional meaning beyond the schema's descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a 'Global regulatory intelligence API' with 8 specific endpoints (privacy, kyc, corporate, etc.), each with a brief purpose (e.g., 'Data privacy law by jurisdiction'). This provides a clear verb+resource. However, it does not explicitly differentiate from sibling tools beyond the general domain of compliance.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description does not provide when-to-use or when-not-to-use guidance relative to siblings. It lists endpoints but does not explain which scenarios are best for this tool vs. other specialized pulse tools (e.g., cyberpulse, esgpulse). No alternatives or exclusions are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
cryptopulseCInspect
CryptoPulse: Global cryptocurrency intelligence API. 10 endpoints: DeFi yield farming across Ethereum/Base/Arbitrum/Solana (DeFiLlama live TVL + APY), personalized strategy builder, crypto security framework (with
Coverage: Global
Endpoints: • yield ($0.10): DeFi yield intelligence • strategy ($0.20): Personalized DeFi strategy builder • security ($0.10): Crypto security framework • threats ($0.10): Crypto threat intelligence • exchange ($0.10): Exchange comparison • tax ($0.20): Crypto tax guidance • onboard ($0.10): First-time buyer onboarding guide • spend ($0.10): Crypto spending guide • banking ($0.10): Crypto-friendly banking guide • merchant ($0.10): Merchant crypto payment setup • research-brief ($0.50): Institutional-grade crypto market research brief — decision-ready synthesis of spot, derivatives (funding/options skew/DVOL), on-chain flows, regional premiums, and macro-event odds. Built for AI financial-advisor agents.
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | goal | |
| lang | No | Response language code | |
| risk | No | Risk profile filter | |
| chain | No | Filter by chain: ethereum, base, arbitrum, berachain, solana, or all | |
| focus | No | Lens to emphasize | |
| setup | No | Current custody setup description | |
| action | Yes | Which endpoint to call. Options: yield | strategy | security | threats | exchange | tax | onboard | spend | banking | merchant | research-brief | |
| assets | No | Comma-separated focus assets | |
| capital | No | Capital in USD | |
| country | No | country | |
| horizon | No | Analysis horizon | |
| profile | No | profile | |
| category | No | Threat category: phishing, drainer, sim_swap, rug_pull, flash_loan, or all | |
| priority | No | priority | |
| tax_year | No | Tax year e.g. 2026. Defaults to current year. | |
| use_case | No | use_case | |
| timeframe | No | Investment timeframe in days | |
| activities | No | Comma-separated: hold, trade, defi, mining, staking, nft, business | |
| experience | No | experience | |
| value_tier | No | value_tier | |
| integration | No | integration | |
| business_type | No | business_type |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description should disclose behavior. It mentions endpoints and pricing but does not state that the tool is read-only, lacks side effects, or has rate limits. The description fails to provide essential behavioral context beyond a list of features.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is overly long and unstructured, mixing marketing language, pricing, and endpoint lists. It is not concise; important functional details are buried in verbose text. The structure does not front-load key information for an agent.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 22 parameters, 11 actions, and no output schema, the description is incomplete. It lists endpoints but does not explain what each action returns, how parameters relate to actions, or provide usage examples. The agent lacks sufficient context to invoke the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, but many parameter descriptions are mere labels (e.g., 'goal', 'profile') adding no meaning. The action parameter has a clear description with enum values. The description adds context for endpoints but not for individual parameters, so it marginally improves understanding.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states it is a 'Global cryptocurrency intelligence API' and lists endpoints, which gives a general idea. However, it does not concisely state that the tool retrieves intelligence data based on an action parameter, and the inclusion of pricing and marketing language blurs the purpose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 its many siblings (e.g., alphapulse, marketpulse). There is no advice on selecting actions or prerequisites, making it difficult for an agent to decide when to invoke this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
cyberpulseBInspect
CyberPulse: Global cybersecurity intelligence API — CVE briefs, vulnerability scanning, CISA KEV, OSINT, threat intelligence, ransomware tracking, breach checks, compliance gap analysis, dark web monitoring, and
Coverage: Global
Endpoints: • cve-brief ($0.10): CVE deep-dive — CVSS, exploitation status, patch urgency, remediation • vuln-scan ($0.12): Vulnerability scan — all known CVEs for any software + version • cisa-kev ($0.08): CISA KEV — Known Exploited Vulnerabilities catalog search • osint ($0.15): OSINT — domain and IP intelligence for authorized defensive use • threat-intel ($0.20): Threat intelligence — global threat actors and campaigns by sector and region • ransomware-intel ($0.20): Ransomware intelligence — group profiles, victim patterns, TTPs, defensive playbook • breach-check ($0.15): Breach check — domain breach history and credential exposure intelligence • compliance-gap ($0.25): Compliance gap analysis — global security frameworks (SOC2, ISO27001, GDPR, NIS2, PDPA, POPIA, LGPD...) • dark-web-monitor ($0.20): Dark web monitor — brand and domain underground intelligence (ethical OSINT) • attack-surface ($0.25): Attack surface assessment — external risk analysis for authorized defensive use
| Name | Required | Description | Default |
|---|---|---|---|
| cve | No | CVE ID — e.g. CVE-2024-3400 | CVE-2023-44487 | CVE-2021-44228 | |
| days | No | Entries added in last N days (default: 90) | |
| lang | No | Response language: en|es|fr|de|ja|zh|ko|pt|ar|hi (default: en) | |
| brand | No | Brand name or domain — e.g. acme.com | MyCompany | |
| group | No | Ransomware group name — e.g. LockBit | ALPHV | Cl0p | RansomHub (omit for landscape overview) | |
| action | Yes | Which endpoint to call. Options: cve-brief | vuln-scan | cisa-kev | osint | threat-intel | ransomware-intel | breach-check | compliance-gap | dark-web-monitor | attack-surface | |
| domain | No | Domain to check — e.g. example.com | |
| filter | No | ransomware | recent (alternative to vendor search) | |
| region | No | Region — e.g. North America | Europe | Southeast Asia | MENA | Sub-Saharan Africa | Global (default: Global) | |
| sector | No | Industry sector — e.g. healthcare | finance | SaaS | e-commerce | |
| target | No | Domain or public IP — e.g. example.com | 8.8.8.8 | |
| vendor | No | Vendor/product name — e.g. Cisco | Ivanti | Microsoft | Palo Alto | Fortinet | |
| company | No | Company name — e.g. Acme Corporation | |
| version | No | Version string — e.g. 2.14.0 | 3.0.8 | |
| industry | No | Sector — e.g. healthcare | finance | energy | manufacturing | government | education | |
| software | No | Software name — e.g. Apache Log4j | OpenSSL | Spring Boot | Ivanti Connect Secure | |
| ecosystem | No | Package ecosystem — npm | PyPI | Maven | Go | crates.io | NuGet | |
| framework | No | Compliance framework |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden of disclosure. It adds cost per endpoint (e.g., $0.10 for cve-brief) and notes 'authorized defensive use' for osint and attack-surface, implying authorization requirements. However, it does not discuss rate limits, authentication, or side effects. The behavior is somewhat transparent but incomplete.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is quite long (over 20 lines) and structured as a bullet list with costs and each endpoint's function. It is not front-loaded; the main purpose is stated but followed by a more detailed list. It could be more concise by combining endpoint descriptions into a more succinct format.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (18 parameters, 10 endpoints, no output schema), the description covers each endpoint's purpose and provides examples for parameters. However, it lacks information on return values, error handling, or usage examples. It is moderately complete but leaves gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% (context signals), so the baseline is 3. The description adds value by providing detailed endpoint descriptions (e.g., 'CVE deep-dive — CVSS, exploitation status, patch urgency, remediation') that clarify the action parameter and give context for other parameters like cve, vendor, etc. This extra information helps an agent understand parameter usage beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it's a global cybersecurity intelligence API covering CVE briefs, vulnerability scanning, CISA KEV, OSINT, threat intelligence, ransomware tracking, breach checks, compliance gap analysis, dark web monitoring, and attack surface assessment. It lists specific endpoints with short descriptions, making the purpose clear. However, it lacks a concise one-line summary and includes trailing text.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no explicit guidance on when to use this tool versus sibling tools (e.g., alphapulse, arbipulse) or alternatives. The description does not mention prerequisites, when not to use, or how to choose between endpoints beyond the action parameter. Implicitly, it's for cybersecurity intelligence, but no clear usage boundaries are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
dealpulseCInspect
DealPulse: Global deal intelligence API. AI-synthesized best deals, price history, coupon discovery, cashback optimization, subscription audits, credit card stack analysis, grocery savings, student discounts, an
Coverage: Global
Endpoints: • store ($0.05): Store coupon codes and promotions • item ($0.08): Best deal on a specific product • compare ($0.08): Live price comparison across retailers • event ($0.10): Sale event intelligence • subscriptions ($0.08): Subscription audit — cancel vs. keep analysis with cost savings • cards ($0.08): Credit card cashback optimization for a purchase or category • stack ($0.10): Deal stacking — combine sale + coupon + cashback for maximum savings • student ($0.05): Student discounts on software, services, food, and travel • history ($0.08): Price history and best-time-to-buy analysis for a product
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | Specific product name (e.g. Samsung 65 inch QN90B, Dyson V15) | |
| lang | No | lang | |
| event | No | Sale event name (e.g. black-friday, prime-day, cyber-monday) | |
| query | No | Product name or description (e.g. 65 inch TV, AirPods Pro) | |
| store | No | Store or restaurant name (e.g. Target, Chilis, Nike) | |
| action | Yes | Which endpoint to call. Options: store | item | compare | event | subscriptions | cards | stack | student | history | |
| budget | No | Maximum budget in USD | |
| country | No | country | |
| category | No | Product category filter (e.g. electronics, appliances, clothing) | |
| retailer | No | retailer | |
| services | No | services |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses per-endpoint costs (e.g., $0.05 per store call), which is a useful behavioral trait, but it does not mention authentication, rate limits, or whether operations are read-only. Given no annotations, the description carries the burden but only partially fulfills it.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description contains a cut-off sentence and redundant phrasing ('DealPulse:'), but the bullet list of endpoints is well-structured. It is not maximally concise, but organized enough for scanning.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of 11 parameters and multiple endpoints, the description lacks guidance on which parameters to use with each action, and does not explain return values (no output schema). This leaves significant gaps for effective tool invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, so the description adds little beyond listing endpoints and their costs. The baseline of 3 is appropriate as the schema already documents all parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a 'Global deal intelligence API' and lists endpoints for best deals, price history, coupons, cashback, etc., establishing a distinct domain. However, the description is cut off and somewhat messy, slightly reducing clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 its siblings (other pulse tools). The description lacks context on selecting this tool over alternatives, leaving the agent without decision support.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
debtpulseCInspect
DebtPulse: Global debt elimination intelligence. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header. Supports US, UK, Australia, and Canada jurisdictions. Add ?lang= for a
Coverage: Global
Endpoints: • payoff ($0.10): Payoff calculator • snapshot ($0.10): Debt burden snapshot • negotiate ($0.15): Creditor negotiation playbook • settle ($0.15): Debt settlement analysis • collections ($0.08): Debt collector rights • statute ($0.05): Statute of limitations lookup • garnishment ($0.08): Wage garnishment analysis • student ($0.12): Student loan strategy • credit ($0.10): Credit repair roadmap • build-credit ($0.10): Credit building strategy • dispute ($0.08): Credit dispute guide • insolvency ($0.20): Insolvency analysis • medical ($0.10): Medical bill negotiation • tax ($0.12): Tax debt relief • bnpl ($0.08): BNPL true cost analysis • payday ($0.10): Payday loan escape • mortgage-relief ($0.12): Mortgage relief options • consolidate ($0.10): Debt consolidation analysis • priority ($0.10): Multi-factor debt priority • rights ($0.05): Consumer debt rights • freedom-roadmap ($0.15): Debt freedom roadmap
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | goal | |
| lang | No | Response language (ISO 639-1 code). Claude responds natively in any language. | |
| type | No | type | |
| debts | No | JSON array: [{creditor, balance, rate, minPayment}] | |
| score | No | score | |
| state | No | US state code (e.g., TX, CA) | |
| action | Yes | Which endpoint to call. Options: payoff | snapshot | negotiate | settle | collections | statute | garnishment | student | credit | build-credit | dispute | insolvency | medical | tax | bnpl | payday | mortgage-relief | consolidate | priority | rights | freedom-roadmap | |
| assets | No | assets | |
| bureau | No | bureau | |
| income | No | Monthly income in USD | |
| lender | No | lender | |
| method | No | method | |
| balance | No | Current balance in USD | |
| country | No | Jurisdiction for country-specific rules and programs | |
| savings | No | savings | |
| creditor | No | Creditor name (e.g., Capital One, Chase, Midland Credit) | |
| fee_rate | No | Fee rate (e.g., '$15 per $100') | |
| platform | No | platform | |
| province | No | CA province or AU state code | |
| servicer | No | servicer | |
| collector | No | Collection agency name | |
| debt_type | No | debt_type | |
| homeowner | No | homeowner | |
| insurance | No | insurance | |
| loan_type | No | Conventional | FHA | VA | USDA | |
| negatives | No | Comma-separated list of negative items | |
| situation | No | situation | |
| goal_score | No | goal_score | |
| amount_owed | No | amount_owed | |
| bill_amount | No | bill_amount | |
| credit_score | No | credit_score | |
| last_payment | No | Date of last payment (YYYY-MM-DD) for expiry calculation | |
| years_behind | No | years_behind | |
| employer_type | No | government | nonprofit | private (for PSLF eligibility) | |
| extra_payment | No | Additional monthly payment amount in USD | |
| months_behind | No | Number of months behind on payments | |
| negative_items | No | negative_items | |
| payment_amount | No | payment_amount | |
| payments_remaining | No | payments_remaining |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden. It mentions payment and jurisdictions but does not explain behavioral traits like what the tool does beyond listing endpoints, how responses are returned, or any limitations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is long and includes a list of endpoints with pricing, mixed with general information. It is not concise and could be better structured to highlight key usage patterns.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 39 parameters, 21 actions, and no output schema, the description is highly incomplete. It does not explain how to use the tool for a specific action, what parameters are relevant for each endpoint, or what the response looks like.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, but many parameter descriptions are terse (just the parameter name). The description does not map parameters to specific endpoints or add meaningful context beyond the schema, failing to compensate for the lack of clarity.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies DebtPulse as a tool for global debt elimination intelligence and lists specific endpoints with brief descriptions. However, it is cluttered with pricing and a long list, which slightly muddles the core purpose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description mentions payment requirements, supported jurisdictions, and endpoint descriptions. However, it lacks explicit guidance on when to use this tool versus alternatives or when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
discoverAInspect
Discover all available PulseNetwork verticals. Returns a categorized list of all 67 intelligence APIs (660+ endpoints) with descriptions, coverage, pricing, and available actions. Use this to find the right vertical for a task.
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | Filter by category: finance | health | law | travel | real-estate | crypto | career | data | global | all |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It discloses that the tool returns a categorized list with specific details (descriptions, coverage, pricing, actions), which is sufficient for a read-only discovery tool. No side effects or auth requirements mentioned, but not critical here.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences packed with relevant information. No unnecessary words. Front-loaded with the main action and resource.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite no output schema, the description fully compensates by detailing the return content. For a simple optional-parameter tool, it provides enough context for an agent to understand the tool's purpose and output.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. Description does not add additional meaning beyond the schema for the 'category' parameter; the schema already describes the filter values. No extra semantic value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the tool's purpose: discovering all PulseNetwork verticals. It specifies the return content (categorized list of 67 APIs, 660+ endpoints, descriptions, coverage, pricing, actions) and distinguishes from sibling tools which are individual verticals.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says 'Use this to find the right vertical for a task,' indicating when to use it. While it doesn't directly state when not to use it, the context of sibling tools implies that if a specific vertical is known, those tools should be used instead.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
econsignalpulseBInspect
EconSignalPulse: Alternative economic intelligence API covering 190+ countries. Combines World Bank Open Data, IMF Datamapper forecasts, satellite nighttime lights research, and AIS shipping signals to produce institu
Coverage: Global
Endpoints: • nightlights ($0.15): Satellite nighttime lights vs official GDP • gdp-tracker ($0.10): GDP tracker — history + IMF forecasts • inflation-signals ($0.08): Multi-source inflation signals • country-brief ($0.25): Full sovereign intelligence brief • divergence ($0.20): Official stats vs alternative data divergence • recession-signals ($0.15): Recession probability signals • frontier-intel ($0.15): Frontier and emerging market intelligence • trade-flows ($0.15): Global trade flow analysis • credit-stress ($0.15): Sovereign credit and banking stress • sanctions-impact ($0.20): Sanctions impact measurement
| Name | Required | Description | Default |
|---|---|---|---|
| iso2 | No | ISO2 country code for World Bank data — e.g. IN | BR | DE | NG | |
| iso3 | No | ISO3 country code for IMF data — e.g. IND | BRA | DEU | NGA | |
| lang | No | Response language | |
| lens | No | Intelligence lens | |
| focus | No | Analysis focus area | |
| action | Yes | Which endpoint to call. Options: nightlights | gdp-tracker | inflation-signals | country-brief | divergence | recession-signals | frontier-intel | trade-flows | credit-stress | sanctions-impact | |
| period | No | Analysis period | |
| regime | No | Sanctions regime to analyze | |
| country | No | Country name — e.g. 'India' | 'Brazil' | 'Germany' | 'Nigeria' | |
| partner | No | Optional trade partner country for bilateral analysis — e.g. 'United States' | 'China' | 'Germany' |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description includes per-endpoint pricing, which is a behavioral disclosure, but lacks information on rate limits, authentication, or side effects; no annotations are provided to supplement.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-organized with a clear endpoint list, but the truncated first sentence and repeated pricing information detract slightly from conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 10 parameters and no output schema, the description fails to explain parameter dependencies, output format, or usage patterns, making it incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, so the description adds little beyond what the schema already provides for parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as an alternative economic intelligence API with global coverage and specific data sources, but the introductory sentence is truncated, slightly reducing completeness.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists endpoints and pricing but provides no guidance on when to use this tool versus sibling pulse tools, nor any conditions for selecting specific endpoints.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
edupulseDInspect
EduPulse: Global education intelligence API — 10 endpoints for students, test-takers, and lifelong learners worldwide. Study guide generation (any subject, any grade level, 190+ countries), adaptive quiz with e
Coverage: Global
Endpoints: • guide ($0.10): Study guide generation — any subject, any grade, any country • quiz ($0.10): Practice quiz with adaptive difficulty and answer explanations • explain ($0.05): Concept explainer — any topic at any level from 5th grade to PhD • schedule ($0.10): Backwards-planned study schedule — from exam date to today, with daily tasks • prep ($1.00): Exam-style practice questions — 200+ exams, rubric-matched difficulty • flashcards ($0.50): Spaced-repetition flashcard set — import into Anki or Quizlet • explain ($0.50): Exam format explainer — complete breakdown of any exam structure and strategy • mock ($1.00): Full mock exam simulation — timed, scored, with performance report • misconception ($0.10): Misconception diagnosis — pinpoints the exact knowledge gap behind a wrong answer • grade ($1.00): Rubric-based exam grading — written response scoring with detailed feedback • co-op-guide ($0.10): Homeschool co-op finder • curriculum-match ($0.10): Homeschool curriculum matcher • essay ($0.25): Admissions essay review • homeschool-laws ($0.10): Homeschool law lookup
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City | |
| date | No | Exam date YYYY-MM-DD | |
| exam | No | exam | |
| lang | No | Response language code (e.g. es, fr, zh, ja) | |
| count | No | count | |
| essay | No | Essay text | |
| focus | No | Focus (academic, social, both) | |
| grade | No | Grade level: K, 1-12 | |
| level | No | Grade level or exam type | |
| state | No | State | |
| style | No | Learning style (any, structured, eclectic, etc.) | |
| topic | No | Specific topic within the subject | |
| action | Yes | Which endpoint to call. Options: guide | quiz | explain | schedule | prep | flashcards | explain | mock | misconception | grade | co-op-guide | curriculum-match | essay | homeschool-laws | |
| answer | No | The student's wrong answer | |
| prompt | No | Essay prompt | |
| school | No | Target school | |
| concept | No | concept | |
| section | No | Exam section (e.g. FAR for CPA) | |
| subject | No | Subject (algebra, biology, chemistry, history, etc.) | |
| audience | No | e.g. 'nursing student', 'Series 7 candidate', 'adult learner' | |
| duration | No | Duration in minutes | |
| question | No | The exam/study question | |
| response | No | The student response to grade | |
| questions | No | questions | |
| religious | No | Religious preference (none, christian, etc.) | |
| child_ages | No | Child ages (e.g. 5-10, all ages) | |
| difficulty | No | difficulty | |
| question_type | No | e.g. NGN, logic-games, task-based-simulation, data-sufficiency | |
| hours_per_week | No | hours_per_week |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must describe behavior. It mentions pricing per endpoint and vague capabilities (e.g., 'pinpoints knowledge gaps'), but omits critical details like whether operations are read-only, destructive, or require authorization. Behavioral traits are inadequately disclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is overly long, listing 14 endpoints with pricing. It is not front-loaded with a clear summary, and the bullet list includes redundant entries (explain appears twice). The structure is verbose without being informative.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (29 parameters, 14 actions), the description is grossly incomplete. It lacks guidance on required combinations, output format, usage constraints, and error scenarios. The agent would be unable to invoke the tool correctly based on this description alone.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Despite 100% schema description coverage, the parameter descriptions are tautological (e.g., 'count' description is 'count', 'difficulty' is 'difficulty'). The lengthy tool description fails to map parameters to specific actions, leaving the agent unable to determine which parameters to use for each endpoint.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description mentions 'Global education intelligence API' and lists 14 endpoints, but does not clearly state what the tool as a whole accomplishes. The overarching purpose is vague, and the list of endpoints reads like a catalog rather than a coherent tool definition.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus its siblings (all 'pulse' tools). The description does not provide context for appropriate usage or mention alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
esgpulseCInspect
ESGPulse: AI-powered ESG and sustainability intelligence: CSRD compliance roadmaps, EU Taxonomy alignment, supply chain due diligence, emissions analysis, greenwashing risk, and ESG disclosure guidance. All end
Coverage: Global
Endpoints: • csrd ($0.25): CSRD compliance roadmap • framework ($0.15): ESG framework navigator • company ($0.15): Company ESG intelligence • emissions ($0.15): Carbon and emissions intelligence • sector ($0.15): SASB sector ESG materiality • taxonomy ($0.20): EU Taxonomy alignment check • supply-chain ($0.20): Supply chain ESG due diligence • score ($0.10): ESG score intelligence • greenwashing ($0.15): Greenwashing risk detector • disclosure ($0.20): ESG disclosure builder
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | Primary reporting goal | |
| lang | No | Response language (ISO 639-1) | |
| focus | No | focus | |
| rater | No | rater | |
| scope | No | scope | |
| topic | No | topic | |
| action | Yes | Which endpoint to call. Options: csrd | framework | company | emissions | sector | taxonomy | supply-chain | score | greenwashing | disclosure | |
| claims | No | Sustainability claims to analyze (e.g. 'carbon neutral by 2030, eco-friendly packaging') | |
| entity | No | Company or entity name (optional) | |
| format | No | format | |
| listed | No | Whether the company is publicly listed | |
| sector | No | Industry sector (retail, manufacturing, financial-services, technology, energy, healthcare, etc.) | |
| company | No | Company name (e.g. Apple, Unilever, HSBC) | |
| activity | No | Specific economic activity (e.g. solar energy generation, manufacture of cement) | |
| turnover | No | Annual turnover in EUR (e.g. 250000000 for €250M) | |
| employees | No | Number of employees (e.g. 500, 5000) | |
| framework | No | framework | |
| objective | No | EU Taxonomy environmental objective to assess | |
| entity_type | No | entity_type | |
| company_type | No | Type of organization | |
| jurisdiction | No | Company's primary jurisdiction | |
| origin_countries | No | Comma-separated list of sourcing countries (e.g. CN,BD,VN) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description must disclose behavior. It only lists endpoints and prices, but does not describe side effects, authorization needs, rate limits, or whether operations are read-only/destructive. Insufficient transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is verbose, includes pricing details that may be unnecessary, and appears truncated ('All end'). It is not front-loaded or concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite 22 parameters and no output schema, the description does not explain how endpoints relate, what output format to expect, or how to choose between endpoints for a given task. The tool is complex but the description is incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 100% schema description coverage (all 22 parameters described in JSON), baseline is 3. The description does not add extra meaning beyond the endpoint list; parameter details are already in the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as AI-powered ESG intelligence, listing specific endpoints (CSRD, taxonomy, etc.) that distinguish it from sibling pulse tools. However, the truncation 'All end' and mixed pricing details slightly reduce clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Endpoint names imply usage scenarios (e.g., csrd for compliance roadmaps), but no explicit guidance on when to use this tool versus alternatives, or when not to use it. The description lacks when/when-not instructions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fanpulseCInspect
FanPulse: Global fandom intelligence API. AI-synthesized fan guides, lore analysis, collectibles valuation, discography deep-dives, character analysis, easter egg discovery, quiz generation, and timeline recons
Coverage: Global
Endpoints: • lore ($0.10): Deep canon lore Q&A • character ($0.08): Character or artist deep profile • quiz ($0.08): AI-generated trivia set • easter-eggs ($0.15): Easter egg and hidden meaning analysis • discography ($0.10): Artist discography deep dive • sorting ($0.08): Personality-based character/faction sorting • timeline ($0.10): Canonical franchise timeline • collect ($0.10): Collectibles and memorabilia market intelligence • compare ($0.10): Decisive cross-franchise or cross-artist comparison
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | item | |
| lang | No | lang | |
| name | No | name | |
| type | No | character|franchise|artist|album | |
| album | No | album | |
| focus | No | focus | |
| query | No | query | |
| topic | No | topic | |
| action | Yes | Which endpoint to call. Options: lore | character | quiz | easter-eggs | discography | sorting | timeline | collect | compare | |
| artist | No | For music artists | |
| subject1 | No | subject1 | |
| subject2 | No | subject2 | |
| franchise | No | franchise | |
| item_type | No | vinyl|photocards|figures|signed|comics|cards|props|memorabilia|general | |
| difficulty | No | easy|medium|hard|mixed | |
| personality | No | personality |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully disclose behavior. It mentions that content is 'AI-synthesized' and lists costs per endpoint, but it does not state whether operations are read-only, any side effects, authentication requirements, or rate limits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description has a front-loaded summary, but the bullet list of endpoints with costs could be more concise. Some redundancy exists (e.g., 'Coverage: Global' is a single line). Not terribly verbose but could be improved.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 16 parameters and 9 endpoints, no output schema, and no examples, the description is incomplete. It does not link parameters to specific endpoints, nor explain what each endpoint returns. A user would need significant trial and error.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, but many parameter descriptions are uninformative (e.g., 'item', 'name', 'focus' are just the parameter name). The tool description does not add semantic value beyond the schema; it only lists endpoint names. Baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it's a global fandom intelligence API covering lore, character analysis, quizzes, etc. The purpose is well-defined, but it does not explicitly distinguish itself from sibling tools like franchisepulse or gamepulse, which might overlap.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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. The description lists endpoints but provides no context for choosing between them or prerequisites. Sibling tools are numerous but not differentiated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fieldpulseBInspect
FieldPulse: Global precision agriculture intelligence API. Synthesizes satellite NDVI data, Open-Meteo soil/weather data, USDA WASDE, FAO, and EPPO into structured, actionable intelligence for growers, agronomist
Coverage: Global
Endpoints: • yield-forecast ($0.15): Yield and production forecast for any crop and region • weather-risk ($0.08): 7-14 day crop-specific weather risk assessment • soil-intel ($0.08): Live soil moisture, temperature, and evapotranspiration intelligence • pest-disease ($0.10): Pest and disease risk assessment with outbreak alerts • irrigation ($0.08): ET0-based irrigation recommendation and water budget • commodity-outlook ($0.10): Agricultural commodity market outlook and price intelligence • input-cost ($0.08): Fertilizer, seed, and crop protection cost intelligence • planting-window ($0.05): Optimal planting window based on soil temperature and frost dates • season-brief ($0.20): Comprehensive seasonal agricultural intelligence brief • crop-health ($0.10): Crop health assessment from satellite + soil data
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude (alternative to region name) | |
| lon | No | Longitude (alternative to region name) | |
| crop | No | Crop: wheat, corn, rice, soybeans, cotton, coffee, cocoa, palm-oil, canola, barley, sorghum | |
| lang | No | Response language ISO 639-1 | |
| action | Yes | Which endpoint to call. Options: yield-forecast | weather-risk | soil-intel | pest-disease | irrigation | commodity-outlook | input-cost | planting-window | season-brief | crop-health | |
| region | No | Named region: 'Black Sea', 'US Midwest', 'Brazil Mato Grosso', 'India Punjab', 'EU', 'Australia', 'Global' | |
| hectares | No | Farm size in hectares (optional — enables total cost estimate) | |
| soil_type | No | Soil type: sandy, loam, clay, silt-loam, sandy-loam, clay-loam |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description must fully disclose behavior. It fails to mention authentication, rate limits, pricing model (though costs per call are noted), error handling, or idempotency. The action is presumably read-only but not explicitly stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is structured with a clear opening sentence, coverage note, and bulleted endpoints. It is front-loaded with the core purpose. However, it is slightly verbose with redundant 'intelligence' phrasing and could be trimmed.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (8 parameters, 10 endpoints, no output schema), the description is insufficient. It does not clarify when to use lat/lon vs region, what data each endpoint returns, or prerequisites (e.g., some endpoints may require specific parameters).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description adds marginal value by explaining each endpoint's purpose (e.g., 'ET0-based irrigation recommendation' for irrigation) but does not elaborate on parameter usage beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool as a global precision agriculture intelligence API synthesizing satellite NDVI, soil/weather, and market data. It lists specific endpoints (yield-forecast, weather-risk, etc.) with brief purposes, distinguishing it from siblings like marketpulse or alphapulse which serve other domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lacks explicit guidance on when to use this tool vs alternatives. It lists endpoints but does not provide conditional logic (e.g., 'use yield-forecast for production estimates, weather-risk for short-term hazards'). No when/when-not or alternative tool mentions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
filingspulseDInspect
FilingsPulse: Global SEC/EDGAR and international filings intelligence API. AI-synthesized plain-language summaries of 10-K, 10-Q, 8-K, S-1/IPO filings. Insider ownership tracking, red flag detection, institutional
Coverage: Global
Endpoints: • exchange ($0.10): Exchange-specific filing intelligence — any listed company worldwide • summary ($0.15): 10-K / Annual Report plain-language summary • insider ($0.10): Insider trading signal — Form 4 analysis • ownership ($0.10): Institutional ownership and 13F analysis • ipo ($0.20): IPO / S-1 prospectus deep dive • 8k ($0.10): Material event analysis (8-K and equivalents) • redflags ($0.15): Forensic accounting red flag scan • compare ($0.15): Side-by-side competitor comparison from filings • search ($0.08): Full-text filing search across all public databases
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | lang | |
| event | No | earnings | executive_change | merger | restatement | debt | cybersecurity | guidance_change | |
| query | No | Optional focus topic (e.g. revenue growth, ESG, M&A) | |
| action | Yes | Which endpoint to call. Options: exchange | summary | insider | ownership | ipo | 8k | redflags | compare | search | |
| ticker | No | Stock ticker (works for US; use company name for international) | |
| company | No | Company name or local ticker (e.g. LVMH, Samsung Electronics, Tata Consultancy Services) | |
| ticker1 | No | ticker1 | |
| ticker2 | No | ticker2 | |
| company1 | No | company1 | |
| company2 | No | company2 | |
| exchange | No | Exchange code — enables precise source targeting and jurisdiction-correct filing terminology | |
| date_from | No | YYYY-MM-DD | |
| form_type | No | form_type |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations, and the description fails to disclose any behavioral traits such as rate limits, authentication, destructive actions, or side effects. It includes pricing but no operational details.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is overly long and includes extraneous information such as pricing per endpoint, making it cluttered. It is not front-loaded with the most important information; an AI agent would have to parse through marketing text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and 13 parameters, the description fails to explain how endpoints relate, what inputs are expected for each action, or what the return values are. It is incomplete for an AI agent to use the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is 100%, many parameter descriptions are mere repetitions of the parameter name (e.g., 'ticker1', 'company1'). Only a few parameters like 'event' and 'action' have meaningful descriptions. The description adds minimal value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description positions the tool as an API for SEC/EDGAR filings with multiple endpoints, but it lacks a single clear verb-resource statement. It reads like a product description rather than defining a specific action for an AI agent.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 the many sibling 'pulse' tools. The description does not differentiate its use case or provide any context for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
findpulseBInspect
FindPulse: Universal finder and discovery API. AI-synthesized best product recommendations, alternative product discovery, grant and scholarship search, used/refurbished alternatives, hidden deals, local busines
Coverage: Global
Endpoints: • product ($0.10): Best product for use case • compare ($0.10): Head-to-head product comparison • alternative ($0.08): Cheaper alternatives • hidden ($0.08): Hidden gem products • used ($0.08): Used/refurbished sourcing guide • local ($0.10): Local professional vetting • grant ($0.10): Grant and funding finder • scholarship ($0.10): Scholarship finder • rental ($0.08): Rent vs buy analysis • recall ($0.05): Product recall lookup
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | item | |
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| field | No | field | |
| state | No | state | |
| action | Yes | Which endpoint to call. Options: product | compare | alternative | hidden | used | local | grant | scholarship | rental | recall | |
| budget | No | budget | |
| product | No | product | |
| profile | No | profile | |
| service | No | service | |
| category | No | category | |
| location | No | location | |
| products | No | products | |
| use_case | No | use_case | |
| frequency | No | frequency | |
| demographic | No | demographic | |
| preferences | No | preferences |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries transparency burden. It discloses pricing per endpoint and global coverage, but missing details on rate limits, authentication, side effects, or return formats. The pricing info is helpful for cost-conscious agents.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Description is lengthy with pricing embedded in bullet points. It front-loads the main purpose but includes many details that could be streamlined. Structure is acceptable but not optimally concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 16 parameters, no output schema, and no annotations, the description should map parameters to endpoints or provide usage examples. It fails to guide which parameters are relevant for each action, leaving the agent to infer from parameter names alone.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% but descriptions are minimal (often just parameter names). The description adds value by documenting the 'action' parameter as an enum of endpoints, clarifying its function. For other parameters, it provides no additional meaning beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Universal finder and discovery API' and lists multiple endpoints with their specific purposes (e.g., 'Best product for use case', 'Cheaper alternatives'). It distinguishes itself from specialized sibling tools by covering a broad range of searches, though not explicitly naming siblings.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description outlines endpoints and their use cases, providing implicit guidance on when to use each. However, it lacks explicit direction on when to prefer findpulse over sibling tools or what factors to consider for endpoint selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fitpulseBInspect
FitPulse: Global fitness intelligence API. Evidence-based workout programming, nutrition science, supplement efficacy analysis, injury recovery protocols, race training plans, sleep optimization, plateau-breaki
Coverage: Global
Endpoints: • workout ($0.10): Custom workout plan • exercise ($0.08): Exercise form guide • nutrition ($0.10): Macro and nutrition targets • supplement ($0.08): Evidence-based supplement analysis • recover ($0.10): Injury recovery protocol • supplements ($0.08): Evidence-graded supplement efficacy tier list by goal • rehab ($0.10): Sports medicine rehabilitation protocol • sleep ($0.08): Athletic sleep optimization and CBT-I protocol • plateau ($0.10): Training plateau analysis and breakthrough protocol • race ($0.10): Race training plan built backwards from event date
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Days per week (default: 4) | |
| goal | No | e.g. muscle-gain, fat-loss, strength, endurance, general-fitness | |
| lang | No | lang | |
| issue | No | Sleep issue (e.g. trouble falling asleep, early waking, poor recovery despite sleep, jet-lag) | |
| level | No | level | |
| sport | No | Target sport or activity for return-to-sport phase | |
| action | Yes | Which endpoint to call. Options: workout | exercise | nutrition | supplement | recover | supplements | rehab | sleep | plateau | race | |
| budget | No | Monthly budget for supplements (e.g. $50, $100, $200) | |
| injury | No | e.g. sprained-ankle, pulled-hamstring, rotator-cuff, shin-splints, runners-knee | |
| weight | No | Body weight in lbs | |
| activity | No | activity | |
| duration | No | How long the plateau has lasted (e.g. 6 weeks, 3 months) | |
| exercise | No | e.g. barbell-squat, push-up, romanian-deadlift, pull-up | |
| equipment | No | e.g. full gym, dumbbells-only, bodyweight (default: full gym) | |
| race_date | No | Race date (YYYY-MM-DD) — plan is built backwards from this date | |
| race_type | No | Race type (5K, 10K, half-marathon, marathon, triathlon-sprint, triathlon-olympic, ironman, OCR) | |
| restrictions | No | Dietary restrictions or intolerances (vegan, lactose-free, etc.) | |
| fitness_level | No | Pre-injury fitness level (recreational, competitive, elite) | |
| runs_per_week | No | Available training days per week | |
| current_fitness | No | Current fitness level and recent training context | |
| current_routine | No | Brief description of current training and diet approach | |
| training_schedule | No | Training schedule context (e.g. morning workouts, evening training, two-a-days) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description only mentions endpoints and pricing, without disclosing behavioral traits such as rate limits, idempotency, or potential side effects. The description does not compensate for missing annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is structured with a heading and bullet list, but it is somewhat lengthy and includes pricing information that may be irrelevant for an AI agent. It could be more concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 22 parameters and no output schema or annotations, the description lacks guidance on how parameters relate to specific endpoints, and does not provide sufficient context for the AI agent to use the tool effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% coverage with parameter descriptions, so the schema already provides meaning. The tool description adds value by grouping endpoints and indicating their purpose, but does not significantly enhance parameter understanding beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Global fitness intelligence API' and lists endpoints covering various fitness domains, indicating a fitness-focused tool. However, it does not explicitly differentiate from sibling tools, though the sibling names suggest different domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for fitness-related queries through its content and endpoint list, but lacks explicit guidance on when to use this tool versus alternatives or any exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
footballpulseBInspect
FootballPulse: Global football/soccer betting intelligence API — match previews, Asian handicap, live in-play intel, value bets, accumulators, league stats, player intelligence, corner/booking markets, clean sheet p
Coverage: Global
Endpoints: • match-preview ($0.15): Match preview — team form, H2H, injuries, xG comparison, key battles, predicted score, and primary bet • value-bets ($0.15): Value bets — EV analysis across 1X2, BTTS, over/under 2.5, and Asian handicap for any matchday • asian-handicap ($0.15): Asian handicap — quarter/half-ball line selection, Pinnacle/Macau intelligence, sharp money indicators • live-intel ($0.15): Live in-play intelligence — momentum, xG trajectory, dangerous attacks, substitution impact, in-play bets • accumulator ($0.15): Accumulator builder — evidence-based multi-match parlay with EV analysis, banker pick, stake guide • league-pulse ($0.10): League intelligence — standings, top scorers, over/under rates, BTTS rates, betting angles • player-intel ($0.10): Player intelligence — goals, assists, xG, injury status, market value, FPL value, card risk • corner-cards ($0.10): Specialty markets — corner statistics, booking points, referee tendencies, over/under probability • clean-sheet ($0.10): Clean sheet probability — GK stats, defensive metrics, BTTS probability, under 2.5 market analysis • transfer-watch ($0.10): Transfer market intelligence — rumours with credibility ratings, squad impact, market valuations
| Name | Required | Description | Default |
|---|---|---|---|
| away | No | away | |
| date | No | date | |
| home | No | home | |
| lang | No | lang | |
| line | No | e.g. -0.5, +1.5, -1.75 | |
| team | No | team | |
| score | No | e.g. 1-0 | |
| action | Yes | Which endpoint to call. Options: match-preview | value-bets | asian-handicap | live-intel | accumulator | league-pulse | player-intel | corner-cards | clean-sheet | transfer-watch | |
| league | No | league | |
| market | No | market | |
| minute | No | minute | |
| player | No | player | |
| season | No | season | |
| window | No | window | |
| leagues | No | leagues | |
| referee | No | referee | |
| max_legs | No | max_legs | |
| strategy | No | strategy | |
| home_away | No | home_away | |
| competition | No | competition |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description does not disclose behavioral traits such as rate limits, authentication requirements, or whether it is read-only. It leaves these aspects unclear.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is relatively long, enumerating endpoints with prices. It is structured with bullet-like formatting but could be more concise. Some information could be moved to the schema or omitted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 20 parameters, no output schema, and missing behavioral context, the description is not sufficiently complete. Critical aspects like how to combine parameters for different endpoints are not explained.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is 100%, many parameter descriptions are merely the parameter name (e.g., 'lang', 'home', 'away') without additional meaning. A few provide examples (e.g., line: 'e.g. -0.5'), but overall the descriptions add little value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a global football/soccer betting intelligence API with specific endpoints. The name 'footballpulse' distinguishes it from siblings like 'alphapulse' or 'marketpulse'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists distinct endpoints with brief use-case explanations (e.g., 'match preview — team form, H2H, injuries'). While it doesn't explicitly compare to siblings, the specificity to football is evident.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
franchisepulseBInspect
FranchisePulse: Global franchise intelligence API. AI-synthesized franchise discovery, FDD analysis, total cost modeling, SBA loan analysis, resale valuation, online/absentee franchise opportunities, and franchise br
Coverage: Global
Endpoints: • fdd ($0.20): Franchise Disclosure Document analysis • discover ($0.15): Franchise opportunity discovery • compare ($0.15): Side-by-side franchise comparison • vet ($0.15): Franchise due diligence • total-cost ($0.10): All-in investment and cost analysis • resale ($0.10): Existing franchise units for sale • online ($0.10): Online business acquisition discovery • sba ($0.08): SBA eligibility and franchise financing • broker ($0.08): Franchise broker and consultant guidance
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | lang | |
| type | No | new_unit|resale|both | |
| action | Yes | Which endpoint to call. Options: fdd | discover | compare | vet | total-cost | resale | online | sba | broker | |
| category | No | SaaS|content|ecommerce|newsletter|app|service | |
| concepts | No | Comma-separated franchise names (min 2) | |
| industry | No | industry | |
| location | No | location | |
| max_price | No | max_price | |
| specialty | No | specialty | |
| territory | No | territory | |
| franchisor | No | franchisor | |
| loan_amount | No | loan_amount | |
| min_revenue | No | min_revenue | |
| max_multiple | No | max_multiple | |
| investment_max | No | investment_max |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description must disclose behavioral traits. It fails to mention whether calls are idempotent, read-only, or have side effects. It also omits authentication requirements, rate limits, or 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is structured with bullet points and a clear list of endpoints. The inclusion of pricing adds minor clutter but overall is concise given the number of endpoints.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 15 parameters, no output schema, and no explanation of parameter-action relationships, the description is incomplete. Agents may struggle to construct valid calls without more context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the input schema already defines each parameter. The description does not add meaning beyond what the schema provides, such as which parameters apply to which action.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as a 'Global franchise intelligence API' and enumerates specific capabilities like franchise discovery, FDD analysis, total cost modeling, etc. This distinguishes it from sibling 'pulse' tools which cover other domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 sibling tools. The description lists endpoints but does not explain under what circumstances to choose franchisepulse over, for example, buildpulse or marketpulse.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gamepulseAInspect
GamePulse: Global gaming intelligence API. AI-synthesized meta analysis, tier lists, gaming hardware recommendations, PC specs optimization, esports match predictions, TCG card valuations (MTG, Pokémon, Yu-Gi-Oh
Coverage: Global
Endpoints: • deals ($0.05): Game deals • worth-it ($0.08): Buy or wait verdict • meta ($0.08): Game meta analysis • trending ($0.05): Trending games • setup ($0.10): PC gaming setup • price ($0.10): Card price analysis • invest ($0.15): Set investment analysis • deal ($0.15): eBay card deal finder • matches ($0.05): Esports matches • team ($0.08): Esports team profile • betting ($0.10): Esports betting analysis • tournament ($0.10): Tournament breakdown • portfolio ($0.10): Trading card portfolio valuation • achievements ($0.08): Achievement hunting guide • specs ($0.08): PC compatibility check • subscription ($0.08): Gaming subscription value calculator • time ($0.05): Game completion time estimator
| Name | Required | Description | Default |
|---|---|---|---|
| cpu | No | CPU model | |
| gpu | No | GPU model | |
| ram | No | RAM (GB) | |
| set | No | set | |
| card | No | card | |
| game | No | Game title or slug e.g. elden-ring, cyberpunk-2077 | |
| lang | No | Response language (default en) | |
| name | No | name | |
| cards | No | Comma-separated card list | |
| games | No | Comma-separated games you play | |
| genre | No | e.g. rpg, action, strategy, fps | |
| match | No | match | |
| action | Yes | Which endpoint to call. Options: deals | worth-it | meta | trending | setup | price | invest | deal | matches | team | betting | tournament | portfolio | achievements | specs | subscription | time | |
| budget | No | Budget in USD ($200-$10,000) | |
| achievement | No | Specific achievement (optional) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden. It discloses per-endpoint costs, which is a behavioral trait, but lacks details on authentication, rate limits, error handling, data freshness, or response structure. The 'AI-synthesized' mention hints at generation but not reliability.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with purpose and structured as a clear list of endpoints with costs. It is informative but slightly verbose due to the endpoint list relative to the schema enum. Every sentence provides value (purpose, coverage, endpoints) with minimal waste.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (15 parameters, 17 endpoints, no output schema), the description lacks important context: it does not describe return formats, error scenarios, rate limits, or authentication requirements. The cost breakdown is helpful but insufficient for complete usage understanding.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with terse parameter descriptions (e.g., 'card' -> 'card'). The description does not elaborate on parameters beyond listing endpoint names; it adds cost context but that is already implied by the enum values. Baseline 3 is appropriate since the description does not significantly augment parameter meaning.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Global gaming intelligence API' and lists specific endpoints (deals, meta, esports, TCG) that distinguish it from sibling tools focused on other domains. The verb 'analyze' or 'provide' is implied by the API nature, making purpose explicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implicitly suggests use for gaming queries via its endpoint list, but provides no explicit guidance on when to use this tool versus sibling *pulse tools. There is no mention of alternatives or exclusions, leaving the agent to infer from domain keywords.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
geopoliticalpulseCInspect
GeopoliticalPulse: Real-time geopolitical intelligence for investors, compliance teams, and AI agents. Political risk, conflict monitoring, sanctions, elections, trade tensions, and regional situational awareness for 19
Coverage: Global
Endpoints: • country-risk ($0.15): Country Risk Assessment • conflict-scan ($0.20): Conflict Scan • sanctions-intel ($0.15): Sanctions Intelligence • election-watch ($0.15): Election Watch • trade-tension ($0.20): Trade Tension Analyzer • regime-brief ($0.20): Regime Brief • event-impact ($0.25): Geopolitical Event Impact • instability-signal ($0.20): Instability Early Warning Signal • supply-chain-risk ($0.20): Supply Chain Geopolitical Risk • regional-brief ($0.15): Regional Situational Brief
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Lookback window in days | |
| lang | No | Response language ISO 639-1 code (en, es, fr, de, ar, zh, pt, ja, ko, ru) | |
| year | No | Election year (e.g., 2025, 2026) | |
| event | No | Event to analyze (e.g., Russia-Ukraine ceasefire, Taiwan strait incident, Iran nuclear deal) | |
| action | Yes | Which endpoint to call. Options: country-risk | conflict-scan | sanctions-intel | election-watch | trade-tension | regime-brief | event-impact | instability-signal | supply-chain-risk | regional-brief | |
| region | No | Country or region to scan (e.g., Ukraine, Gaza, Sudan, Myanmar, Sahel) | |
| sector | No | Sector or commodity (e.g., semiconductors, rare earths, lithium, pharmaceuticals, energy, food) | |
| target | No | Country, entity, or individual to assess (e.g., Russia, Iran, North Korea, Huawei) | |
| country | No | Country name or code (e.g., Russia, China, Iran, Venezuela, Nigeria) | |
| country_a | No | First country (e.g., US, EU, China, India) | |
| country_b | No | Second country (e.g., China, Russia, Taiwan, Mexico) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. The description does not disclose behavioral traits such as rate limits, authentication requirements, error handling, or side effects. The inclusion of pricing is unusual but not about behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is long and reads like a product page, with unnecessary details like pricing per endpoint. It could be much shorter and more focused on the tool's function.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description explains the overall function but fails to describe return values (no output schema), constraints, or how parameters relate. For a complex tool with 11 parameters, more context is needed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers all 11 parameters with descriptions (100% coverage). The description adds a list of endpoints with pricing, which provides some extra context for the 'action' parameter, but otherwise does not add meaning beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states it provides 'real-time geopolitical intelligence' and lists many endpoints, making the general purpose clear. However, it does not differentiate from siblings like policypulse or tradepulse, and the title is null.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use geopoliticalpulse vs other pulse tools. No when-not or alternatives mentioned. The description assumes the agent infers usage from the name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
govspendpulseBInspect
GovSpendPulse: Global government procurement intelligence API. 9 endpoints covering US federal contracts (USASpending.gov), active solicitations (SAM.gov), EU tenders (TED), UK contracts, global development bank opp
Coverage: Global
Endpoints: • us-contracts ($0.08): US federal contract awards • us-opportunities ($0.08): US active solicitations (SAM.gov) • eu-tenders ($0.08): EU procurement tenders (TED) • uk-contracts ($0.08): UK government contracts • global-opportunities ($0.15): Global procurement opportunities • agency-intel ($0.15): US agency spending intelligence • competitor-awards ($0.15): Competitor federal award analysis • development-bank ($0.15): Development bank procurement • contract-brief ($0.20): Full contract intelligence brief
| Name | Required | Description | Default |
|---|---|---|---|
| cpv | No | CPV procurement code — e.g. 72000000 (IT services) | |
| lang | No | Response language | |
| limit | No | Number of results (5, 10, or 20) | |
| naics | No | NAICS code — e.g. 541512 (computer systems design) | |
| state | No | Two-letter US state code — e.g. VA, CA, TX | |
| action | Yes | Which endpoint to call. Options: us-contracts | us-opportunities | eu-tenders | uk-contracts | global-opportunities | agency-intel | competitor-awards | development-bank | contract-brief | |
| active | No | Only return open solicitations | |
| agency | No | Agency name or abbreviation — e.g. DHS, VA, HHS, DoD, NASA, GSA | |
| country | No | ISO 2-letter country code — e.g. DE, FR, PL, NL (blank = all EU) | |
| keyword | No | Search term — e.g. cybersecurity, cloud computing, management consulting | |
| regions | No | Comma-separated regions: australia, canada, asia, africa, latam, mena, un | |
| year_from | No | Fiscal year start — e.g. 2024, 2025 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must disclose behavioral traits. It includes per-endpoint costs but fails to mention read-only status, authentication requirements, rate limits, or any side effects. This leaves significant gaps for a data retrieval API.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is structured with a clear header and bullet list of endpoints, making it easy to scan. However, it is verbose with pricing details that may not be essential for tool selection. The purpose is front-loaded, but the length slightly reduces conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 12 parameters and no output schema, the description should compensate by explaining return values and parameter interactions. It only provides high-level coverage (endpoints and data sources) without specifying what data each endpoint returns or how parameters like 'cpv', 'naics', and 'keyword' relate. This leaves the agent with incomplete context for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so each parameter has a basic description. The tool description adds context by listing endpoints and their costs but does not elaborate on parameter usage beyond what the schema provides. The 'action' parameter is well-defined by its enum, but others like 'keyword', 'agency', etc., lack additional semantic guidance.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a global government procurement intelligence API with 9 specific endpoints covering major data sources (USASpending, SAM.gov, TED, etc.). The name 'govspendpulse' aligns perfectly with this purpose, and the level of detail distinguishes it from sibling tools that focus on other domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the tool should be used for government procurement intelligence but does not explicitly state when to use it over alternatives or provide exclusions. It lists endpoints and data sources, leaving the agent to infer the appropriate context without clear guidance on when not to use this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
grantpulseCInspect
GrantPulse: Grant discovery and application intelligence API. 8 endpoints powered by Grants.gov, USASpending.gov, and Claude. All endpoints require x402 payment (USDC on Base mainnet). Flagship match endpoint inc
Coverage: Global
Endpoints: • match ($0.15): Personalized grant matching • federal ($0.10): Federal grant search • state ($0.10): State grant programs • foundation ($0.12): Foundation grant intelligence • eligibility ($0.10): Grant eligibility analysis • apply ($0.15): Grant application strategy • deadline ($0.08): Grant deadline tracker • writer ($0.20): Grant narrative drafting • eu ($0.12): EU funding intelligence • global ($0.15): Global development funding
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | days | |
| lang | No | lang | |
| size | No | size | |
| state | No | state | |
| action | Yes | Which endpoint to call. Options: match | federal | state | foundation | eligibility | apply | deadline | writer | eu | global | |
| agency | No | agency | |
| sector | No | arts | health | education | environment | technology | agriculture | community | housing | science | |
| country | No | EU member state | |
| keyword | No | keyword | |
| mission | No | mission | |
| section | No | section | |
| category | No | category | |
| location | No | location | |
| org_type | No | nonprofit | small_business | individual | public_university | private_university | state_government | local_government | tribal | for_profit | other | |
| grant_name | No | grant_name | |
| eligibility | No | eligibility | |
| org_profile | No | org_profile | |
| org_description | No | org_description | |
| project_description | No | project_description |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. The description mentions payment requirement (x402, USDC) and coverage, but is cut off ('Flagship match endpoint inc') and lacks details on error handling, rate limits, or data behavior. Incomplete and missing critical behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a mix of narrative and list, but it's cut off and poorly structured. It includes redundant details (endpoint list with prices) that could be appended. The incomplete sentence ('Flagship match endpoint inc') indicates sloppy formatting.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has 19 parameters and no output schema or annotations. The description fails to explain return values, error responses, endpoint behaviors, or how parameters interact across endpoints. The cut-off text makes it severely incomplete for an agent to use correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so baseline is 3. Many parameter descriptions are tautological (e.g., 'days', 'lang'), adding little value. The 'action' parameter and a few others (sector, country, org_type) provide meaningful lists. Overall, the description adds marginal value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it's a grant discovery and application intelligence API with multiple endpoints. However, it doesn't differentiate from the many sibling 'pulse' tools, which cover diverse domains like alpha, arbi, climate, etc. The purpose is evident but sibling context is missing.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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. The description lists endpoints but doesn't explain selection criteria or when not to use it. Given the many sibling tools, explicit usage context is needed.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gridpulseBInspect
GridPulse: Global energy grid intelligence API. NREL + EIA + Open-Meteo data synthesis. Home solar feasibility, electricity rate analysis, time-of-use optimization, EV charging cost modeling, battery storage ROI
Coverage: Global
Endpoints: • prices ($0.08): Electricity prices by state • grid ($0.08): Power grid status by region • renewable ($0.08): Renewable energy profile by state • natural-gas ($0.08): Henry Hub natural gas briefing • forecast ($0.10): 90-day energy forecast by state • ev-cost ($0.08): EV charging cost vs gasoline • solar ($0.10): Home solar feasibility analysis • appliance ($0.05): Home appliance energy cost calculator • battery ($0.10): Home battery storage analysis • carbon ($0.05): Household electricity carbon footprint • community-solar ($0.08): Community solar enrollment by ZIP code • tou ($0.08): Time-of-use rate optimization
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | US ZIP code (preferred) | |
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| miles | No | Annual miles (1,000-100,000) | |
| state | No | 2-letter US state code (TX, CA, NY, etc.) | |
| action | Yes | Which endpoint to call. Options: prices | grid | renewable | natural-gas | forecast | ev-cost | solar | appliance | battery | carbon | community-solar | tou | |
| has_ev | No | true if household has an EV (major TOU savings driver) | |
| region | No | ercot | caiso | pjm | miso | isone | nyiso | spp | |
| utility | No | Utility name (e.g., PGE, SCE, ConEd) for utility-specific TOU plans | |
| age_years | No | Appliance age in years (affects upgrade ROI calculation) | |
| appliance | No | Appliance type (hvac, water-heater, refrigerator, washer, dryer, dishwasher, lighting) | |
| has_solar | No | true if existing or planned solar system | |
| system_kw | No | System size in kW (2-20) | |
| monthly_kwh | No | Average monthly electricity consumption in kWh | |
| usage_hours | No | Daily usage hours (default varies by appliance) | |
| monthly_bill | No | Average monthly electricity bill in USD | |
| household_size | No | Number of people in household | |
| outage_priority | No | Priority for outage backup (essential-only, whole-home, ev-charging) | |
| credit_preference | No | Preference for bill credit vs. direct payment programs |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully convey behavioral traits. It mentions global coverage and endpoint costs but does not disclose side effects, idempotency, authentication requirements, or rate limits. This is insufficient for a tool with many parameters.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with bullet points for endpoints, front-loading the core purpose. While not extremely concise, each sentence contributes useful information without redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (18 parameters, no output schema), the description covers the endpoints adequately but lacks details on return values, error handling, or prerequisites for each endpoint. More context on typical responses would improve completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents parameters. The description adds context by listing endpoints with short descriptions, but does not significantly enhance parameter understanding beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the domain (energy grid intelligence) and the types of analysis it provides (solar feasibility, rate analysis, etc.), making it highly specific and distinguishable from the many sibling tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists endpoints but does not explicitly guide when to use this tool over siblings or which endpoint to choose for a given task. The domain specificity provides implicit guidance, but explicit usage context is missing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
harvestpulseCInspect
HarvestPulse: Global farm-to-table and agricultural intelligence API. USDA + ERS data synthesis. Local food finder (farmers markets, CSAs, on-farm markets), seasonal produce calendars, organic certification lookup,
Coverage: Global
Endpoints: • find ($0.05): Local Farm & Market Finder • season ($0.05): Seasonal Produce Calendar • labels ($0.08): Food Label Decoder • organic ($0.08): Certified Organic Farm Finder • dirty-dozen ($0.05): Dirty Dozen & Clean Fifteen • food-hub ($0.08): Regional Food Hub Finder • regenerative ($0.10): Regenerative Agriculture Guide • designations ($0.10): Global Food Designations • agritourism ($0.05): Agritourism & U-Pick Finder • csa ($0.10): CSA Evaluation Guide • cost ($0.10): Local vs. Conventional Cost Analysis • roadmap ($0.15): Farm-to-Table Lifestyle Roadmap • food-preservation ($0.10): Food preservation guide • foraging-intel ($0.10): Foraging intelligence • livestock-basics ($0.10): Backyard livestock guide
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | US ZIP code | |
| city | No | City name (optional filter) | |
| lang | No | Response language (default en) | |
| type | No | Type (plants, mushrooms, berries, all) | |
| goals | No | Specific goals (e.g. reduce pesticides, support local farms, eat seasonally) | |
| items | No | Produce items to compare (space or comma separated) | |
| label | No | Label to decode (e.g. free-range, natural, pasture-raised, grass-fed, non-GMO) | |
| month | No | Month (1-12). Defaults to current month. | |
| query | No | Search terms (e.g. beef, dairy, grain) | |
| state | No | 2-letter US state code (e.g. CA, TX, NY) | |
| action | Yes | Which endpoint to call. Options: find | season | labels | organic | dirty-dozen | food-hub | regenerative | designations | agritourism | csa | cost | roadmap | food-preservation | foraging-intel | livestock-basics | |
| animal | No | Animal (chickens, goats, bees, etc.) | |
| method | No | Method (canning, fermenting, dehydrating, freezing, pickling) | |
| radius | No | Search radius in miles | |
| season | No | Season (spring, summer, fall, winter) | |
| climate | No | Climate (temperate, arid, etc.) | |
| country | No | Country (for international calendar) | |
| produce | No | Produce to preserve | |
| product | No | Product name (e.g. parmigiano-reggiano, champagne, prosciutto-di-parma, roquefort) | |
| location | No | City/state or region | |
| quantity | No | Quantity (e.g. small batch) | |
| weekly_budget | No | Weekly food budget in USD | |
| household_size | No | Number of people in household | |
| land_size_sqft | No | Available land in sq ft |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, and the description does not disclose behavioral traits like authentication, rate limits, or side effects. It only lists endpoint costs, which is insufficient for a tool with 24 parameters.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is long due to listing all 15 endpoints with prices. While front-loaded with the domain, it could be more concise by grouping or omitting redundant details.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description lacks guidance on how to compose parameters for each endpoint, what each endpoint returns, or relationships between parameters. For a complex tool with 24 params, it is incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all parameters. The description adds minimal extra meaning, mainly listing endpoint names with brief summaries, but does not elaborate on parameter usage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's domain as 'farm-to-table and agricultural intelligence' and lists specific endpoints, but lacks explicit differentiation from sibling tools, which are also in different domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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, or when not to use it. It simply describes the API without context for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
herbapulseBInspect
HerbaPulse: Global herbal medicine and botanical intelligence API. PubMed-grounded herb profiles, drug-herb interaction checker, traditional medicine system guides (Ayurveda, TCM, Amazonian, African), herbal reme
Coverage: Global
Endpoints: • herb ($0.12): Herb profile • remedy ($0.10): Cross-cultural remedy lookup • ingredient ($0.10): Supplement decoder • interaction ($0.10): Herb-drug interaction checker • skin ($0.08): Natural skincare ingredient • tradition ($0.08): Healing tradition deep dive • practitioner ($0.08): Practitioner guide • cannabis ($0.12): Cannabis and cannabinoid intelligence
| Name | Required | Description | Default |
|---|---|---|---|
| drug | No | drug | |
| herb | No | herb | |
| lang | No | lang | |
| type | No | naturopath | herbalist | tcm | ayurveda | homeopath | integrative-md | |
| topic | No | anxiety | pain | sleep | epilepsy | nausea | inflammation | general | |
| action | Yes | Which endpoint to call. Options: herb | remedy | ingredient | interaction | skin | tradition | practitioner | cannabis | |
| concern | No | anti-aging | acne | hydration | sensitivity | |
| product | No | product | |
| compound | No | Default: both | |
| location | No | location | |
| condition | No | condition | |
| tradition | No | tradition | |
| ingredient | No | ingredient | |
| ingredients | No | ingredients |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It mentions 'PubMed-grounded' data source and lists endpoints with pricing, but it does not disclose mutability, required permissions, rate limits, or whether the tool is read-only. Behavioral traits are insufficiently communicated for a tool with no annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with bullet points for endpoints and pricing, making it scannable. However, it is somewhat verbose (e.g., repeating 'Coverage: Global' and listing prices) and could be more concise. The first sentence is cut off but still interpretable. Overall, it earns its place with clear organization.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having 14 parameters and no output schema, the description provides a reasonable overview of capabilities. However, it lacks guidance on which parameters are required for each endpoint, and the absence of output schema details leaves gaps. For a complex tool, more description is needed to be fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 does not add significant meaning beyond the schema; it lists endpoints but does not explain how parameters relate to each action (e.g., which parameters are needed for 'herb' vs 'interaction'). The description fails to compensate for the lack of parameter usage guidance.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'HerbaPulse: Global herbal medicine and botanical intelligence API' and lists specific endpoints (herb profile, drug-herb interaction checker, tradition guides, etc.). This distinguishes it from sibling tools with different domains (e.g., alphapulse, autopulse), making the purpose unmistakable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for herbal medicine queries but does not explicitly state when to use this tool over alternatives or provide 'when-not' guidance. No alternative tool names are mentioned, and the context signals (many sibling tools) suggest domain specificity, but explicit usage guidelines are absent.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
homepulseBInspect
HomePulse: Global home intelligence API. AI-synthesized home maintenance checklists, improvement ROI analysis, neighborhood research, smart home integration, energy efficiency guidance, contractor task briefings
Coverage: Global
Endpoints: • value ($0.10): Home value estimate • neighborhood ($0.10): Neighborhood analysis • improve ($0.10): Home improvement ROI analysis • maintain ($0.08): Seasonal maintenance checklist • rent ($0.08): Rental market analysis • contractor ($0.10): Contractor vetting guide • energy ($0.10): Home energy efficiency • maintenance ($0.08): Personalized home maintenance calendar • roi ($0.10): Home improvement resale ROI • smart ($0.08): Smart home ecosystem advisor
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Home age (years) | |
| zip | No | ZIP code | |
| city | No | city | |
| lang | No | lang | |
| room | No | Room | |
| sqft | No | Square footage | |
| state | No | state | |
| trade | No | Trade (plumber, electrician, roofer, etc.) | |
| action | Yes | Which endpoint to call. Options: value | neighborhood | improve | maintain | rent | contractor | energy | maintenance | roi | smart | |
| budget | No | Budget USD | |
| county | No | County name hint for HUD FMR matching | |
| region | No | US region or state (e.g. Northeast, Pacific Northwest) | |
| season | No | Defaults to current season | |
| address | No | Street address | |
| project | No | Project type (e.g. kitchen-remodel, deck-addition, new-roof) | |
| bedrooms | No | bedrooms | |
| features | No | Home features (pool, well, etc.) | |
| home_age | No | Home age (years) | |
| ecosystem | No | Ecosystem (Alexa, HomeKit, Google Home) | |
| home_type | No | Home type (single-family, condo, etc.) | |
| home_value | No | Current estimated home value in USD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions AI-synthesis and global coverage but does not disclose rate limits, destruction potential, or authorization needs. The cost info adds some transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the title but includes a verbose list of endpoints with costs. It is structured with bullet points but could be more concise without losing information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema is provided, and the description does not explain return format or how parameters map to actions. For a complex tool with 21 parameters and 10 endpoints, this leaves significant gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description does not add meaning beyond the schema; it only lists endpoint names and costs. It fails to link parameters to specific endpoints, which is a gap.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Global home intelligence API' and lists ten endpoints with brief purposes. It distinguishes from sibling tools, which cover other domains like health or finance. However, the purpose is slightly diluted by the long endpoint list.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies use for home-related queries but does not explicitly state when to use this tool versus other 'pulse' siblings. It lists endpoints but provides no guidance on which parameters are required for each action, limiting usage clarity.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
immigrationpulseCInspect
ImmigrationPulse: Global immigration intelligence API serving 281M+ migrants. 11 endpoints covering visa requirements, PR pathways, points calculators (Express Entry CRS, SkillSelect), digital nomad visas, citizenship
Coverage: Global
Endpoints: • visa ($0.15): Visa requirements — any nationality + any destination • pathway ($0.20): Permanent residency roadmap — every pathway ranked for nationality + destination • nomad ($0.15): Digital nomad visa finder — 50+ countries ranked by income threshold + lifestyle • citizenship ($0.15): Citizenship by investment, ancestry, and naturalization intelligence • status ($0.10): USCIS case status decoder with processing time context • bulletin ($0.10): US Visa Bulletin decoder — priority dates, filing chances, wait estimates • retirement ($0.10): Global retirement visa intelligence — best countries for retirees • compare ($0.15): Side-by-side immigration comparison across multiple destination countries • rights ($0.10): Immigrant rights by country and visa type • cost ($0.10): Complete immigration cost breakdown — government fees + attorney + hidden costs • points ($0.10): Skilled-worker points calculator — Canada Express Entry CRS, Australia SkillSelect, UK PBS, Germany Chancenkarte, Austria Red-White-Red Card
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Applicant age in years (e.g. '31') | |
| clb | No | Canadian Language Benchmark score (for Express Entry, e.g. '9'). CLB 9 = IELTS 7.0; CLB 10 = IELTS 7.5+. | |
| form | No | Form type (e.g. I-485, I-130, I-765, N-400, I-140, I-539) | |
| lang | No | BCP-47 language code (e.g. es, fr, pt, hi, zh, ar) | |
| type | No | type | |
| ielts | No | Overall IELTS band score (e.g. '7.5') — used if clb not provided | |
| action | Yes | Which endpoint to call. Options: visa | pathway | nomad | citizenship | status | bulletin | retirement | compare | rights | cost | points | |
| budget | No | Budget in USD for investment citizenship (e.g. 150000, 500000, 1000000) | |
| income | No | Monthly income in USD | |
| region | No | Filter by region (e.g. Europe, Southeast Asia, Latin America, Caribbean) | |
| status | No | Status message to decode (e.g. 'Case Was Received', 'Request for Evidence', 'Case Was Approved') | |
| system | No | Which immigration points system to evaluate. Use 'any' to assess all relevant systems. | |
| partner | No | Whether applicant has a spouse/common-law partner with qualifying skills/language | |
| receipt | No | USCIS receipt number (e.g. MSC2190012345, SRC2112345678) | |
| ancestry | No | Country for ancestry citizenship check (e.g. Italy, Ireland, Germany) | |
| category | No | category | |
| priority | No | priority | |
| education | No | Highest education level (e.g. bachelor, master, PhD) | |
| job_offer | No | Whether applicant has a valid job offer from a qualifying employer | |
| visa_type | No | Visa or form type (e.g. I-485, EB-2, H-1B, F-1, Canada Express Entry, UK Skilled Worker) | |
| local_work | No | Years of work experience inside the destination country | |
| nomination | No | Whether applicant has a provincial/state nomination (adds +600 CRS for Canada) | |
| occupation | No | Job title or NOC/SOC code — improves pathway matching | |
| preference | No | preference | |
| work_years | No | Years of skilled work experience outside the destination country | |
| destination | No | destination | |
| family_size | No | Number of dependents to include in cost model | |
| nationality | No | nationality | |
| visa_status | No | Visa type or immigration status (e.g. H-1B, F-1, Green Card, TN, Skilled Worker, ILR) | |
| destinations | No | Comma-separated destination countries (2–5) | |
| chargeability | No | Country of chargeability (usually birth country) | |
| priority_date | No | Your priority date (YYYY-MM-DD) — enables personalized filing eligibility check | |
| with_attorney | No | Include attorney fee estimate (default: true) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. The description mentions pricing per endpoint but does not disclose behavioral traits such as authentication needs, rate limits, error responses, or side effects. Given the lack of annotations, the description fails to compensate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with bullet points but is verbose (multiple paragraphs). It could be more concise by focusing on the core routing mechanism and reducing extraneous pricing details.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a complex tool with 11 sub-actions and 33 parameters, the description is incomplete. It does not map parameters to endpoints, explain output format, or handle error scenarios. An AI agent lacks sufficient context to use it effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, but the description adds little beyond the schema. Many parameter descriptions in the schema are terse (e.g., 'destination' as just 'destination'), and the tool description does not explain how parameters interact with specific endpoints or add usage context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description identifies the tool as an immigration intelligence API and lists 11 endpoints, but it does not succinctly state that the tool is an endpoint router selected by the 'action' parameter. The purpose is clear but could be more focused for an AI agent.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 sibling tools (e.g., alphapulse, travelpulse) or when to avoid it. The description lists endpoints but does not provide decision criteria or context for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
insurepulseBInspect
InsurePulse: AI-synthesized insurance intelligence. Auto coverage analysis, life insurance needs calculator, homeowners gap finder, annual coverage audit, and renters insurance guidance. All endpoints require x402
Coverage: Global
Endpoints: • auto ($0.10): Auto insurance analysis • life ($0.10): Life insurance needs calculator • home ($0.10): Homeowners insurance gap analysis • review ($0.15): Annual insurance coverage review • renters ($0.08): Renters insurance guide • business ($0.10): Business insurance guidance • claim ($0.08): Insurance claims guidance • disability ($0.10): Disability insurance analysis • life-event ($0.10): Life-event insurance checklist • rate ($0.08): Insurance rate optimizer • umbrella ($0.08): Umbrella insurance analysis
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Applicant age | |
| dog | No | Whether tenant has a dog (affects liability) | |
| zip | No | ZIP code for rate context | |
| debt | No | Other debt (student loans, auto, credit card) in USD | |
| lang | No | Response language | |
| sqft | No | Square footage | |
| event | No | Life event (marriage, baby, home-purchase, divorce) | |
| state | No | State of registration (e.g. 'Texas', 'CA') | |
| value | No | Home value or purchase price in USD | |
| action | Yes | Which endpoint to call. Options: auto | life | home | review | renters | business | claim | disability | life-event | rate | umbrella | |
| income | No | Annual gross income in USD | |
| country | No | ISO country code (e.g. US, UK, DE, CA, AU) — tailors norms and benchmark anchors. Default US. | |
| details | No | Additional context | |
| profile | No | Driver profile description (e.g. 'clean record 10 years, married, homeowner') | |
| revenue | No | Annual revenue USD | |
| vehicle | No | Vehicle description (e.g. '2020 Toyota Camry') | |
| location | No | City and state (e.g. 'Austin TX') | |
| mortgage | No | Remaining mortgage balance in USD | |
| policies | No | Current policies held (e.g. 'auto,home,life,umbrella') | |
| employees | No | Employee count | |
| net_worth | No | Estimated net worth (in local currency) for umbrella/liability sizing | |
| owns_home | No | Owns home (yes/no) | |
| situation | No | Life situation description (e.g. 'married, 2 kids, dual income') | |
| deductible | No | Policy deductible USD | |
| dependents | No | Number of financial dependents | |
| life_stage | No | Recent life events (e.g. 'new baby', 'home purchase', 'retirement') | |
| occupation | No | Occupation | |
| employer_ltd | No | Existing employer long-term disability (yes/no/details) | |
| teen_drivers | No | Teen drivers (yes/no) | |
| business_type | No | Business type (e.g. consulting, retail, contractor) | |
| insurance_type | No | Insurance type (auto, home, renters) | |
| current_premium | No | Current premium USD | |
| damage_estimate | No | Estimated damage USD | |
| rental_property | No | Owns rental property (yes/no) | |
| current_coverage | No | Current dwelling coverage amount in USD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided. The description does not disclose behavioral traits beyond listing endpoints and pricing. It mentions 'All endpoints require x402' but does not explain what that means (authentication key). No information on side effects, rate limits, response format, or data handling.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is moderately concise, starting with a clear purpose statement. The endpoint list is structured in bullet points with pricing, but some repetition (e.g., 'Auto insurance analysis' and 'auto ($0.10): Auto insurance analysis'). The 'x402' requirement is important but not explained.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 35 parameters and 11 endpoints, the description does not map which parameters apply to which endpoint. No output schema is present, and the description does not explain return values or response structure. The tool is complex, but the description provides only a high-level endpoint list.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage for all 35 parameters, each with clear descriptions. The tool description does not add additional meaning beyond the schema. Since schema already documents parameters, the description adds no extra value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'AI-synthesized insurance intelligence' and lists 11 specific endpoints with their purposes (e.g., 'Auto insurance analysis'). The name 'insurepulse' aligns with insurance domain, distinguishing it from sibling tools like 'alphapulse' or 'arbipulse' which cover other domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the tool is for insurance-related queries by listing endpoints, but does not explicitly state when to use this tool over others. No 'when not to use' guidance or alternatives are provided. Usage context is implicit through the endpoint list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
legalpulseBInspect
LegalPulse: Global legal intelligence API — 10 endpoints covering the full legal lifecycle for individuals, entrepreneurs, and small businesses. Demand letter generation ($0.25), contract analysis + red flag iden
Coverage: Global
Endpoints: • letter ($0.25): Advocacy letter writer • contract ($0.10): Contract clause review • tenant ($0.10): Tenant rights by state • employment ($0.10): Employment law rights • business ($0.10): Business formation comparison • estate ($0.10): Estate planning checklist • consumer ($0.10): Consumer rights — FDCPA, FCRA, FTC • small-claims ($0.08): Small claims court guide • ip ($0.10): Intellectual property guide • rights ($0.08): Know your rights
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| type | No | type | |
| issue | No | issue | |
| state | No | state | |
| action | Yes | Which endpoint to call. Options: letter | contract | tenant | employment | business | estate | consumer | small-claims | ip | rights | |
| amount | No | amount | |
| clause | No | clause | |
| outcome | No | outcome | |
| recipient | No | recipient | |
| situation | No | situation | |
| entity_type | No | entity_type | |
| contract_type | No | contract_type |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full responsibility. It only lists endpoints and prices, without disclosing behavioral traits like authorization needs, rate limits, or data handling. This is insufficient for a tool with 12 parameters.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the tool name and purpose, but it is verbose due to listing all endpoints with prices. It could be more concise while retaining clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 12 parameters and 10 endpoints, the description is too brief per endpoint. It lacks details on how to use each endpoint, required parameters, and output format, making it incomplete for effective selection and invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema adequately describes parameters. The description adds no further semantic context beyond listing endpoint names and brief purposes.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states 'LegalPulse: Global legal intelligence API' and lists 10 specific endpoints covering the legal lifecycle. It clearly differentiates from sibling tools by focusing on legal topics.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies use for legal queries by listing endpoints, but it does not provide explicit guidance on when to use this tool vs. alternatives, nor does it mention when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
longevitypulseAInspect
LongevityPulse: Global longevity intelligence API — biomarker interpretation, supplement evidence, personalized protocols, clinical trials, Blue Zone research, WHO country longevity profiles, epigenetic clocks, dieta
Coverage: Global
Endpoints: • biomarker ($0.15): Biomarker interpretation through longevity science lens • supplement-intel ($0.20): Evidence-graded longevity supplement intelligence • protocol-builder ($0.25): Personalized longevity protocol — exercise, nutrition, sleep, supplements • clinical-trials ($0.10): Search active longevity clinical trials globally from ClinicalTrials.gov • blue-zone ($0.10): Blue Zone intelligence — world longevity hotspots deep-dive • country-longevity ($0.12): WHO country longevity profile — life expectancy, HALE, healthcare, initiatives • epigenetic-clock ($0.20): Epigenetic aging clocks — biological age science, testing, and reversal • diet-intel ($0.15): Evidence-graded dietary analysis for longevity and healthspan • longevity-drug ($0.20): Pharmaceutical longevity intelligence — rapamycin, metformin, senolytics • longevity-clinic ($0.12): Global longevity clinic guide — destinations, treatments, red flags
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Age in years — e.g. 35 | 52 | 65 | |
| sex | No | Biological sex — male | female | |
| diet | No | Diet pattern — e.g. Mediterranean | time-restricted eating | fasting mimicking diet | Blue Zone plant-based | MIND diet | caloric restriction | ketogenic | Japanese traditional | |
| drug | No | Drug name — e.g. rapamycin | metformin | acarbose | dasatinib | fisetin | senolytics | empagliflozin | semaglutide | |
| lang | No | Response language: en|es|fr|de|ja|zh|ko|pt|ar|hi (default: en) | |
| zone | No | Blue Zone or region — e.g. Okinawa | Sardinia | Ikaria | Nicoya | Loma Linda | Blue Zones overview | Hunza | Vilcabamba | |
| goals | No | Longevity goals — e.g. maximize healthspan | cardiovascular health | cognitive longevity | muscle preservation | reverse biological age | |
| topic | No | Topic — e.g. GrimAge | DunedinPACE | biological age overview | how to reverse biological aging | epigenetic reprogramming | how to test biological age | |
| value | No | Lab result with unit — e.g. 85 mg/dL | 2.1 mg/L | 5.4% | 420 ng/dL (optional — enables personalized assessment) | |
| action | Yes | Which endpoint to call. Options: biomarker | supplement-intel | protocol-builder | clinical-trials | blue-zone | country-longevity | epigenetic-clock | diet-intel | longevity-drug | longevity-clinic | |
| budget | No | Budget level — low | moderate | high | $200/month | |
| country | No | Country name — e.g. Japan | Singapore | Spain | South Korea | Switzerland | Costa Rica | Australia | United States | India | Nigeria | |
| compound | No | Compound name — e.g. NMN | NR | berberine | spermidine | urolithin A | fisetin | quercetin | alpha-ketoglutarate | resveratrol | taurine | |
| biomarker | No | Biomarker name — e.g. ApoB | hs-CRP | HbA1c | testosterone | IGF-1 | homocysteine | Lp(a) | ferritin | vitamin D | DHEA-S | |
| condition | No | Condition or intervention — e.g. aging | rapamycin | metformin | NMN | senolytics | caloric restriction | Alzheimer prevention | |
| treatment | No | Treatment of interest — e.g. stem cell therapy | NAD+ IV | peptide therapy | hyperbaric oxygen | plasmapheresis | ozone therapy | |
| conditions | No | Health conditions — e.g. type 2 diabetes | hypertension | none | |
| recruiting_only | No | Show only recruiting trials (default: true) |
TDQS
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 endpoints and their costs, but does not mention potential side effects, authentication, or rate limits. However, it is likely a read-only data API, so the lack of destructive action warnings is acceptable.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a header, coverage note, and bullet-pointed endpoints. It is front-loaded with the general purpose. However, it is somewhat lengthy and could be more concise by grouping related information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description covers all endpoints adequately but lacks guidance on how parameters interact with specific actions. Without an output schema, it would benefit from explaining return values or result formats. Overall, it is sufficient but has gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 adds endpoint-level context but does not elaborate on parameter usage beyond what the schema provides. It could clarify which parameters are relevant for which actions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as a global longevity intelligence API with specific endpoints for biomarker interpretation, supplement evidence, and more. It distinguishes itself from sibling tools by its focus on longevity, which is evident from the name and content.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists all endpoints and their purposes, making it clear when to use this tool (for longevity-related queries). While it doesn't explicitly compare to alternatives, the sibling tool names suggest different domains, so usage context is clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
macropulseBInspect
MacroPulse: Real-time macro intelligence for forex and CFD traders. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header.
Coverage: Global
Endpoints: • session-brief ($0.10): Forex session brief • event-pulse ($0.20): Economic event deep-dive • crypto-pulse ($0.05): Crypto market context • commodities-pulse ($0.10): Commodities brief • equities-pulse ($0.10): Equities pulse • calendar ($0.10): Weekly economic calendar • cot ($0.15): CFTC Commitment-of-Traders positioning for FX and commodity agents — institutional net positioning and weekly shifts across 7 major pairs plus gold and WTI, with crowding and contrarian signals. • eia-inventory ($0.10): Weekly EIA petroleum inventory intelligence for energy and macro agents — crude, gasoline and distillate builds and draws versus expectations, with the oil-price and CAD/NOK implications. • intermarket ($0.15): Cross-asset intermarket synthesis for macro agents — bond yields, equities, commodities and FX read together to surface the dominant regime and the divergences that tend to lead price. • rates-differential ($0.10): Interest-rate differential and carry intelligence for FX agents — G10 policy rates, yield spreads and the carry-trade map that drives durable currency trends. • regime ($0.10): Macro regime classifier for multi-asset agents — labels the current environment (risk-on/off, reflation, stagflation, tightening) and its directional implications for FX, rates and equities. • sentiment ($0.05): Real-time directional sentiment for any forex pair or gold — retail crowd positioning, COT institutional alignment, and a clear contrarian bias call. Built for FX trading and advisor agents.
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| pair | No | pair | |
| event | No | Economic event identifier | |
| action | Yes | Which endpoint to call. Options: session-brief | event-pulse | crypto-pulse | commodities-pulse | equities-pulse | calendar | cot | eia-inventory | intermarket | rates-differential | regime | sentiment | |
| session | No | Trading session. Auto-detected from UTC time if omitted. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It discloses payment requirement and endpoint costs, but does not mention rate limits, failure modes, or read-only nature. Behavioral traits beyond payments are absent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a clear purpose statement upfront, followed by a bullet list of endpoints. It is appropriately sized given the number of actions, though some redundancy exists in listing costs twice.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (numerous endpoints, payment requirement, no output schema), the description provides sufficient context for a developer to understand what each action returns and how to use it. Missing return format details are partially offset by endpoint descriptions.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with parameter descriptions, so baseline is 3. The description adds value for the 'action' enum by listing endpoints with costs and brief outputs, but other parameter descriptions remain minimal and unchanged.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool provides real-time macro intelligence for forex and CFD traders, listing endpoints with brief descriptions. While it distinguishes from unrelated tools, it doesn't explicitly differentiate from similar sibling 'pulse' tools beyond naming.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description mentions a payment requirement via PAYMENT-SIGNATURE header but gives no guidance on when to use this tool versus alternatives (e.g., other pulse tools). No context on when not to use it or which endpoint to choose based on user need.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
marketpulseCInspect
MarketPulse: Marketing intelligence API for the AI era. LLM visibility, channel mix, content briefs, ad copy, local SEO, email sequences, competitor gap analysis, social strategy, ROI forecasting, and technical SE
Coverage: Global
Endpoints: • llm-visibility ($0.15): LLM visibility analysis • content-brief ($0.15): Dual-optimized content brief • channel-mix ($0.10): Marketing channel mix strategy • roi-forecast ($0.08): Marketing ROI forecast • competitor-gap ($0.10): Competitor gap analysis • ad-copy ($0.08): Ready-to-use ad copy variants • email-sequence ($0.15): Email nurture sequence • social-strategy ($0.08): Platform social media strategy • local-seo ($0.08): Local SEO optimization guide • seo-audit ($0.10): Technical SEO audit
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | goal | |
| lang | No | lang | |
| brand | No | brand | |
| goals | No | goals | |
| stage | No | stage | |
| topic | No | topic | |
| action | Yes | Which endpoint to call. Options: llm-visibility | content-brief | channel-mix | roi-forecast | competitor-gap | ad-copy | email-sequence | social-strategy | local-seo | seo-audit | |
| budget | No | budget | |
| product | No | product | |
| website | No | website | |
| audience | No | audience | |
| business | No | business | |
| channels | No | channels | |
| industry | No | industry | |
| location | No | location | |
| platform | No | platform | |
| competitor | No | competitor | |
| business_type | No | business_type | |
| sequence_type | No | sequence_type |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description must disclose behavioral traits. It includes pricing per endpoint but omits read-only/mutation nature, required permissions, rate limits, error handling, or return format. The description is incomplete for safe invocation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is structured with bullet points but includes an incomplete sentence ('and technical SE') and some redundancy. It is not overly verbose, but could be tighter and front-loaded better.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 19 parameters and 10 endpoints, the description fails to clarify parameter usage per endpoint or output structure. The one-line endpoint descriptions are insufficient for an agent to understand what each action returns or requires.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema description coverage is 100%, the descriptions are merely parameter names (e.g., 'goal' -> 'goal'). The tool description adds no additional meaning, and the relationship between parameters and endpoints is unclear. The high coverage is superficial.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description identifies marketpulse as a marketing intelligence API and lists many capabilities and endpoints, making its purpose clear. However, it lacks a concise verb+resource statement and is more of a catalog than a focused description.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 versus siblings or between endpoints. The domain name differentiates from other 'pulse' tools, but the description does not provide when-to-use or when-not-to-use context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mealpulseCInspect
MealPulse: Global meal planning and culinary intelligence API. AI-synthesized meal plans, recipe generation, dietary restriction guidance, grocery optimization, pantry utilization, batch cooking, food budgeting,
Coverage: Global
Endpoints: • plan ($0.15): Weekly meal plan • recipe ($0.08): Recipe with technique tips • grocery ($0.10): Grocery list by store section • pantry ($0.10): Pantry-to-meal ideas • batch ($0.10): Batch cooking guide • dietary ($0.08): Dietary restriction guide • budget ($0.10): Budget meal strategy • substitute ($0.05): Ingredient substitutions • leftover ($0.08): Leftover transformation • kitchen ($0.08): Kitchen equipment advisor
| Name | Required | Description | Default |
|---|---|---|---|
| dish | No | dish | |
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| meals | No | meals | |
| store | No | store | |
| action | Yes | Which endpoint to call. Options: plan | recipe | grocery | pantry | batch | dietary | budget | substitute | leftover | kitchen | |
| budget | No | budget | |
| people | No | people | |
| reason | No | reason | |
| concern | No | concern | |
| cuisine | No | cuisine | |
| dietary | No | dietary | |
| location | No | location | |
| servings | No | servings | |
| leftovers | No | leftovers | |
| experience | No | experience | |
| ingredient | No | ingredient | |
| ingredients | No | ingredients | |
| preferences | No | preferences | |
| cooking_style | No | cooking_style |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description bears full responsibility. It mentions 'Coverage: Global' and per-endpoint costs, which are useful, but lacks information on authentication, rate limits, error handling, or what the response contains. The behavioral disclosure is minimal.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is moderately structured with a bullet list of endpoints. However, it includes redundant phrasing ('MealPulse:') and can be trimmed. It is front-loaded with the main purpose but contains unnecessary repetition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 19 parameters and no output schema, the description is incomplete. It does not explain which parameters are relevant for each action, the expected input format, or return values. The complexity is high, but the description provides insufficient guidance.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema description coverage is 100%, many parameter descriptions are tautological (e.g., 'dish': 'dish'), adding no meaning. The tool description does not explain parameter usage or how they map to endpoints. The descriptions do not compensate for the low-quality schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as a meal planning and culinary intelligence API, listing endpoints like plan, recipe, grocery, etc. It distinguishes from sibling 'pulse' tools by the domain, but the description could be more explicit about the overall purpose without relying on the list.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 vs alternatives. The description lists endpoints but does not indicate scenarios where mealpulse is preferred over other pulse tools, nor does it provide decision criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mindpulseAInspect
MindPulse: Global mental health intelligence API. Evidence-based guidance on therapy platform matching, mental health assessment, burnout, psychiatric medication context, coping techniques, sleep disorders (CBT-
Coverage: Global
Endpoints: • match ($0.10): Therapy platform matching • assessment ($0.10): Mental health self-assessment • burnout ($0.10): Burnout assessment and recovery protocol • medication ($0.10): Psychiatric medication context • technique ($0.08): Evidence-based coping technique guide • sleep ($0.08): Sleep disorder guidance (CBT-I protocol) • grief ($0.08): Grief and loss support • relationship ($0.10): Relationship and communication guidance • workplace ($0.08): Workplace mental health guidance • crisis (FREE): Crisis resource routing — ALWAYS FREE
| Name | Required | Description | Default |
|---|---|---|---|
| drug | No | Medication name (generic or brand — e.g., sertraline, Zoloft, quetiapine) | |
| lang | No | Response language (e.g., es, fr, de, ja) | |
| role | No | Job role or profession | |
| type | No | Type of loss (spousal, parent, child, pet, relationship, identity, health) | |
| action | Yes | Which endpoint to call. Options: match | assessment | burnout | medication | technique | sleep | grief | relationship | workplace | crisis | |
| budget | No | Monthly budget in USD (e.g., 60, 100, 200) | |
| impact | No | How symptoms impact daily function (mild/moderate/severe) | |
| concern | No | Mental health concern to address (e.g., panic+attacks, rumination, anger) | |
| country | No | User's country for localized crisis resources | |
| concerns | No | Mental health concerns (e.g., depression,anxiety,trauma) | |
| duration | No | How long symptoms have been present (e.g., 3+months) | |
| modality | No | Preferred therapy modality (CBT, DBT, ACT, coaching) | |
| severity | No | Severity description (e.g., unable+to+fall+asleep, waking+frequently) | |
| condition | No | Condition it is prescribed for | |
| insurance | No | Insurance carrier or 'self-pay' | |
| situation | No | Describe the burnout situation (e.g., 5+years+ICU+nursing) | |
| jurisdiction | No | Country/jurisdiction for legal framework (US, UK, CA, AU) | |
| time_since_loss | No | Time since the loss (e.g., 2+weeks, 3+months) | |
| relationship_type | No | Type of relationship (romantic, family, friendship, work) | |
| approach_preference | No | Preferred approach type (CBT, DBT, ACT, mindfulness, somatic) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the behavioral transparency burden. The description discloses pricing per endpoint (e.g., $0.10, $0.08), which is valuable behavioral context. It also notes 'Coverage: Global' and that 'crisis' is always free. This goes beyond what the schema provides. However, it does not mention rate limits, response formats, or error handling, which would be beneficial but not severely lacking.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is relatively long (over 20 lines) but well-structured with a brief intro, coverage note, and bullet-pointed endpoints. Some redundancy exists (e.g., 'Coverage: Global' is a single line). It could be more concise by merging endpoint descriptions into the action enum's description, but the structure aids readability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (20 parameters, 10 actions) and no output schema, the description is moderately complete. It explains each endpoint's purpose and pricing, which helps an agent decide which action to call. However, it does not describe return values or expected response structures, which would be helpful for a tool with many output possibilities. The schema covers input parameters well, so the description need not repeat them.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, meaning all parameters have descriptions. The list of endpoints in the description adds context to the 'action' parameter by explaining what each action does. For parameters like 'concern', 'condition', 'situation', the schema descriptions are adequate. The description does not add significant new semantics beyond the schema, so a baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'MindPulse: Global mental health intelligence API' and lists specific endpoints (match, assessment, burnout, etc.) with their purposes. This provides a specific verb+resource combination and distinguishes it from sibling tools that are likely domain-specific pulses (e.g., chronicapulse, legalpulse). The tool's focus on mental health is explicit and well-delineated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists endpoints and costs, which implicitly helps decide which action to use. However, it does not explicitly state when to use MindPulse versus sibling tools (e.g., when to use MindPulse vs. clinicalintelpulse). There is no guidance on prerequisites or contraindications. The 'crisis' endpoint is marked as FREE, which is good context, but overall usage context is only moderately clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nutripulseCInspect
NutriPulse: Global nutrition intelligence API. PubMed-grounded supplement analysis, macro/micronutrient planning, food database lookups, glucose/metabolic health guidance, lab result interpretation, longevity nut
Coverage: Global
Endpoints: • research ($0.10): Nutrition research synthesis • food ($0.08): Food nutrition profile • supplement ($0.10): Supplement analysis • plan ($0.15): Personalized nutrition plan • compare ($0.08): Food comparison • analyze ($0.08): Meal analysis • stack ($0.12): Supplement stack • glucose ($0.10): CGM glucose pattern interpretation • interactions ($0.10): Supplement interaction checker • labs ($0.15): Blood work interpretation • longevity ($0.10): Longevity protocol synthesis • prenatal ($0.10): Prenatal nutrition by trimester
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Age | |
| sex | No | Sex | |
| diet | No | diet | |
| goal | No | goal | |
| lang | No | lang | |
| meal | No | meal | |
| name | No | name | |
| foods | No | Comma-separated food names e.g. chicken,beef,tofu | |
| goals | No | Health goals | |
| query | No | query | |
| topic | No | topic | |
| action | Yes | Which endpoint to call. Options: research | food | supplement | plan | compare | analyze | stack | glucose | interactions | labs | longevity | prenatal | |
| budget | No | budget | |
| context | No | Additional context | |
| markers | No | Comma-separated lab markers and values | |
| pattern | No | Glucose pattern description or readings | |
| calories | No | calories | |
| trimester | No | Trimester (1, 2, 3) | |
| conditions | No | Existing conditions | |
| medications | No | Comma-separated medications | |
| supplements | No | Comma-separated supplements |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. The description does not disclose behavioral traits such as data freshness, rate limits, error handling, or how parameters interact. Mentions 'PubMed-grounded' but no further details on sourcing or coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is lengthy, includes a bullet list with pricing, and has marketing language. It could be more concise and structured for quick consumption.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 21 parameters and 12 actions, the description provides an overview but lacks guidance on which parameters are needed for each action, expected output, or examples. No output schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 repeats some parameter names in the endpoint list but does not add significant new meaning beyond the schema's descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the domain (global nutrition intelligence) and lists 12 specific endpoints covering various nutrition and health areas, distinguishing it from sibling tools that focus on other domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 (e.g., herbapulse, mealpulse). Also lacks instructions on which endpoint to choose for a given task, requiring the agent to infer from endpoint names.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
onchainpulseBInspect
OnchainPulse: Intelligence API for the onchain financial transition. Decodes legislation, tracks RWA tokenization, models sector scenarios, guides onchain integration. All endpoints require x402 payment (USDC on Ba
Coverage: Global
Endpoints: • legislation ($0.15): Legislative intelligence — plain English bill translation with sector impact • rwa ($0.15): Real world asset intelligence — market data and institutional tracking • scenario ($0.20): Sector impact scenario modeling — if/then structural analysis • transition ($0.10): Onchain transition guide — practical onboarding by type • monitor ($0.10): Institutional onchain activity monitor — weekly/monthly brief • compliance ($0.15): Regulatory compliance intelligence — jurisdiction-specific framework guidance • tokenize ($0.15): Tokenization intelligence — how to tokenize any asset type • yield ($0.25): Tokenized yield intelligence — live rates and risk-adjusted comparison • glossary ($0.05): Plain English decoder — any onchain finance or regulatory term • snapshot ($0.10): State of the transition — weekly/monthly macro brief • memecoin ($0.015): Solana memecoin pre-trade safety + momentum verdict (deterministic, no-LLM) • evmtoken ($0.015): EVM memecoin pre-trade safety + momentum verdict (deterministic, no-LLM, multi-chain)
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Bill name or topic (e.g. 'GENIUS Act', 'stablecoin regulation', 'MiCA') | |
| lang | No | Response language (ISO 639-1 code) | |
| mint | No | SPL token mint address (base58) | |
| risk | No | Risk tolerance for recommendations framing | |
| term | No | Term to explain (e.g. 'atomic settlement', 'MiCA', 'CASP', 'yield bearing stablecoin', 'RWA') | |
| type | No | Type of transition | |
| chain | No | EVM chain (default base) | |
| scope | No | scope | |
| topic | No | topic | |
| action | No | Type of analysis | |
| period | No | period | |
| sector | No | Sector to focus on, or 'all' for comprehensive coverage | |
| address | No | ERC-20 token contract address (0x + 40 hex) | |
| context | No | Additional context about the user's situation | |
| trigger | No | The development to model (e.g. 'GENIUS Act passes', 'DTCC full tokenization launch', 'MiCA enforcement begins') | |
| use_case | No | What the entity wants to do (e.g. 'issue a stablecoin', 'operate a crypto exchange', 'accept USDC payments') | |
| framework | No | Specific framework to focus on (e.g. 'MiCA', 'GENIUS Act') | |
| timeframe | No | timeframe | |
| asset_type | No | Asset type to analyze (e.g. 'real estate', 'equity', 'bond', 'private credit', 'art') | |
| asset_class | No | Specific asset class focus (e.g. 'US Treasuries', 'real estate', 'private credit') | |
| jurisdiction | No | Jurisdiction to focus on |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral burden. It mentions the x402 payment requirement (though truncated) and notes that memecoin endpoints are deterministic and no-LLM. However, it lacks details on rate limits, data freshness, or other behaviors. Incomplete payment information reduces clarity.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is lengthy but uses bullet points for endpoints, aiding scanning. However, the initial sentence is dense, and the payment info is cut off. It could be more concise without losing essential details.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 21 parameters, no output schema, and no annotations, the description fails to explain how parameters map to endpoints. The truncation of payment details and lack of workflow guidance leave the agent underinformed for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 100% coverage with parameter descriptions that are adequate (e.g., 'Bill name or topic' for q). The tool's description adds no extra parameter semantics beyond listing endpoint names and prices. Baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly defines OnchainPulse as an intelligence API for onchain financial transition, with specific verbs like 'Decodes legislation, tracks RWA tokenization, models sector scenarios, guides onchain integration.' It distinguishes from sibling *pulse tools by its unique domain focus.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists endpoints with prices but does not explicitly state when to use this tool versus alternatives. Sibling tools cover other domains, so the domain-specific naming implies usage context, but no direct guidance on when not to use or alternatives is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
parentpulseCInspect
ParentPulse: ParentPulse — child development and parenting intelligence: developmental milestones, nutrition guidance, pediatric health, sleep science, school selection, discipline strategies, childcare cost, and
Coverage: Global
Endpoints: • milestone ($0.10): Developmental milestone guidance • safety ($0.08): Product safety recall check • school ($0.10): School selection guidance • activity ($0.08): Activity and extracurricular finder • finance ($0.12): Family financial planning • sleep ($0.10): Pediatric sleep guidance • nutrition ($0.10): Pediatric nutrition guidance • discipline ($0.10): Positive discipline guidance • childcare ($0.12): Childcare options comparison • health ($0.10): Pediatric symptom triage
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | age | |
| zip | No | zip | |
| ages | No | ages | |
| lang | No | lang | |
| brand | No | brand | |
| grade | No | grade | |
| action | Yes | Which endpoint to call. Options: milestone | safety | school | activity | finance | sleep | nutrition | discipline | childcare | health | |
| budget | No | budget | |
| income | No | income | |
| concern | No | concern | |
| behavior | No | behavior | |
| children | No | children | |
| symptoms | No | symptoms | |
| interests | No | interests | |
| situation | No | situation | |
| age_months | No | age_months | |
| priorities | No | priorities | |
| product_type | No | product_type |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It lists endpoints and per-call costs but discloses no other behavioral traits such as authentication requirements, rate limits, side effects, or parameter dependencies. The agent gets minimal insight into how the tool behaves beyond its basic function.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is moderately concise with a clear list of endpoints, but there is a formatting issue (an incomplete 'and' at the end) and redundancy in the first sentence. It is front-loaded with the overall purpose but could be tighter.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 18 parameters, 10 endpoints, and no output schema, the description is insufficient. It fails to explain parameter-endpoint relationships, return format, or any procedural nuances. The agent lacks crucial information to use the tool effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema description coverage is 100%, the descriptions are merely the parameter names (e.g., 'age' -> 'age'), adding no semantic value. The tool description lists endpoints but does not explain which parameters are relevant for each action, leaving the agent to guess.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's domain (child development and parenting intelligence) and lists specific endpoints, making the purpose evident. However, the formatting is slightly messy with a repeated name and an incomplete sentence fragment, and sibling differentiation is weak despite the unique domain.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description does not provide guidance on when to use this tool versus its many sibling 'pulse' tools. It lists endpoints but offers no context on selection based on user needs (e.g., when to prefer parentpulse over mealpulse or nutripulse). No exclusions or alternatives are mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
patentpulseAInspect
PatentPulse: PatentPulse — global IP intelligence: USPTO/EPO/WIPO/JPO/CNIPA patent search, FTO analysis, SEP licensing, trademark clearance, prior art, and competitor patent landscape. Multilingual.
Coverage: Global
Endpoints: • global ($0.12): Jurisdiction-specific patent search — EPO, CNIPA, KIPO, JPO, WIPO PCT, DPMA, UKIPO, CIPO, IP Australia, INPI • search ($0.08): Global patent search (USPTO + global synthesis) • cliff ($0.15): Pharma patent cliff analysis • fto ($0.20): Freedom-to-operate analysis • assignee ($0.10): Company patent portfolio intelligence • prior-art ($0.12): Prior art search • status ($0.05): Patent status lookup • trends ($0.10): Patent filing trends • sep ($0.15): Standard Essential Patent landscape • competitor ($0.15): Competitor R&D intelligence • trademark ($0.06): Trademark clearance search
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search query — technology keyword or assignee/company name | |
| id | No | Patent number (e.g. 10000000 or US10,000,000) | |
| cpc | No | CPC classification code (e.g. G06N, H01M) | |
| area | No | Technology area (e.g. CRISPR, solid-state battery, large language models) | |
| drug | No | Drug name — generic or brand (e.g. humira, ozempic, keytruda) | |
| lang | No | lang | |
| mark | No | Trademark to search (e.g. PulsePay, NeuralFlow) | |
| type | No | type | |
| goods | No | Goods or services description (e.g. payment software, clothing, restaurant services) | |
| action | Yes | Which endpoint to call. Options: global | search | cliff | fto | assignee | prior-art | status | trends | sep | competitor | trademark | |
| company | No | Company or institution name (e.g. Qualcomm, MIT, Samsung) | |
| country | No | Target jurisdiction (e.g. US, EU, China, Japan, global) | |
| standard | No | Technology standard | |
| invention | No | Invention description — be specific about the novel aspects | |
| technology | No | Technology or product description for FTO analysis | |
| jurisdiction | No | Patent office code. EP = EPO (Europe), WO = WIPO PCT (international), CN = CNIPA (China), KR = KIPO (Korea), JP = JPO (Japan), DE = DPMA (Germany), GB = UKIPO, CA = CIPO (Canada), AU = IP Australia, IN = IPO India, BR = INPI (Brazil) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description adds pricing per endpoint and mentions coverage and multilingual capabilities. However, it lacks disclosure of rate limits, authentication requirements, or response format, which are important for behavioral transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a general overview followed by a bullet list of endpoints. However, it is verbose with repeated formatting and includes costs which may not be essential for agent selection. Could be more concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (16 parameters, multiple endpoints) and no output schema, the description covers the primary use cases and parameter purposes well. It lacks details on return values or pagination, but the endpoint descriptions provide sufficient context for selection.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, but the description adds meaningful context beyond schema, such as listing example values for 'drug' (humira, ozempic) and providing jurisdiction codes in the 'jurisdiction' parameter description. This helps the agent understand parameter usage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states 'global IP intelligence' and lists numerous specific endpoints (e.g., USPTO/EPO patent search, FTO, SEP), clearly differentiating it from sibling 'pulse' tools which target other domains. The verb 'search, analyze' is implied through endpoint names.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides detailed endpoint-specific guidance (e.g., 'global' for jurisdiction-specific search, 'fto' for freedom-to-operate) and includes contextual parameters like 'jurisdiction' and 'standard'. However, it does not explicitly exclude use cases or mention alternatives among siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
petpulseBInspect
PetPulse: Global pet health and care intelligence API. AI-synthesized veterinary symptom triage, breed selection guides, pet nutrition analysis, medication safety (drug interactions, toxin exposure), senior pet
Coverage: Global
Endpoints: • symptoms ($0.10): Symptom triage • research ($0.10): Veterinary research synthesis • nutrition ($0.10): Condition-based nutrition guidance • medication ($0.08): Veterinary drug reference • breed ($0.08): Breed health and care guide • cost ($0.08): Vet procedure cost estimator • insurance ($0.10): Pet insurance comparison • senior ($0.10): Senior pet care • toxin ($0.10): Pet toxicity assessment • travel ($0.08): Pet travel guide
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Pet age (e.g. 8 years) | |
| drug | No | Drug name (e.g. carprofen, metronidazole, apoquel) | |
| lang | No | Response language (e.g. es, de, fr) | |
| breed | No | Breed name (e.g. golden-retriever, french-bulldog, maine-coon) | |
| topic | No | Research topic (e.g. joint-supplements, omega-3-benefits) | |
| action | Yes | Which endpoint to call. Options: symptoms | research | nutrition | medication | breed | cost | insurance | senior | toxin | travel | |
| origin | No | Origin country (default US) | |
| region | No | Region | |
| weight | No | Pet weight (e.g. 65lbs) | |
| species | No | Animal species | |
| symptoms | No | Comma-separated symptoms (e.g. lethargy,vomiting) | |
| condition | No | Health condition (e.g. pancreatitis, kidney-disease, obesity) | |
| procedure | No | Procedure name | |
| substance | No | Substance ingested | |
| conditions | No | Existing conditions | |
| destination | No | Destination | |
| amount_ingested | No | Amount ingested |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It states the API is 'AI-synthesized' and lists costs per endpoint, but does not disclose that it is a paid external service, rate limits, or authentication needs. Behavioral aspects like pagination or response format are absent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is organized with a header and bullet list, making it scannable. However, the header is truncated ('senior pet') and the line breaks feel arbitrary. It is fairly concise for the amount of information but could be more front-loaded with the core function.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 17 parameters and no output schema, the description should clarify parameter-endpoint mappings and usage patterns. It only lists endpoints without linking to required parameters. A complex tool like this needs more contextual guidance to be complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 adds no new parameter meanings; it only lists endpoints. The schema already describes each parameter adequately (e.g., 'age', 'drug'). The description does not compensate or enrich parameter semantics.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly defines the tool as a pet health API with 10 specific endpoints, each with a one-line purpose (e.g., 'Symptom triage', 'Breed health and care guide'). It is unambiguous and distinguishes itself from the many 'pulse' sibling tools by being pet-focused.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists endpoints but does not explain when to use this tool over alternatives or when not to use it. It implies usage through endpoint names but lacks explicit context or exclusion criteria. For a tool with 10 actions, guidance on selecting the right endpoint is missing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
policypulseCInspect
PolicyPulse: PolicyPulse — global legislative intelligence: US Congress, EU (EUR-Lex), UK Parliament, India, Brazil, Australia, and 50+ jurisdictions. Bill summaries, sector impact, passage probability, treaty ana
Coverage: Global
Endpoints: • legislation ($0.15): Legislation — plain English translation of any bill globally • impact ($0.15): Impact — who is affected and what they must do • scenario ($0.20): Scenarios — if/then sector impact modeling • monitor ($0.10): Monitor — weekly/monthly legislative activity brief • state ($0.10): State — legislation across all 50 US states via Open States • compliance ($0.15): Compliance — what to do after a law passes • regulation ($0.15): Federal regulation — agency rules via Federal Register • compare ($0.15): Compare — cross-jurisdiction policy comparison • calendar ($0.10): Calendar — upcoming regulatory deadlines and effective dates • translate ($0.08): Translate — decode any legal or regulatory text into plain English • court ($0.15): Court decision intelligence • treaty ($0.10): International treaty and trade-agreement intelligence
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Bill name or topic (e.g. 'NLRB joint employer rule', 'ACA employer mandate', 'EU AI Act') | |
| law | No | Law or regulation (e.g. 'OSHA heat stress standard', 'ADA', 'California CCPA', 'FTC non-compete ban') | |
| lang | No | Response language (ISO 639-1 code) | |
| text | No | Legal or regulatory text to decode (up to 4,000 chars; use POST for longer text) | |
| type | No | Type (fta, climate, tax, all, etc.) | |
| court | No | Court (scotus, cjeu, all, etc.) | |
| state | No | 2-letter state code (TX) or comma-separated list (CA,TX,NY) | |
| topic | No | topic | |
| action | No | action | |
| agency | No | Federal agency (EPA|FDA|OSHA|FTC|CFPB|SEC|DOL|USDA|HHS|FCC|etc) | |
| period | No | period | |
| sector | No | Sector focus (or 'all') | |
| context | No | context | |
| parties | No | Parties involved | |
| trigger | No | The development to model (e.g. 'federal $15 minimum wage passes', 'FTC non-compete ban upheld', 'California single-payer healthcare enacted') | |
| lookahead | No | Days ahead to surface deadlines | |
| entity_type | No | Filter to specific entity type (e.g. 'employer under 50 employees') | |
| jurisdiction | No | jurisdiction | |
| jurisdictions | No | Comma-separated jurisdictions (e.g. 'US,EU,UK,Canada,Australia') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. The description does not disclose behavioral traits such as authentication, rate limits, or whether the tool is read-only. It only lists endpoints and costs, which does not add behavioral context beyond the schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is verbose and cluttered with pricing and a long list of endpoints. Key purpose is not front-loaded, and excessive details detract from conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 19 parameters and no output schema or annotations, the description is incomplete. It fails to explain how parameters map to endpoints, what outputs to expect, or any behavioral nuances, leaving significant gaps for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 does not add meaning beyond the schema; it lists endpoints separately without linking them to parameters. It neither improves nor significantly worsens understanding of parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description lists multiple endpoints and pricing but does not clearly state what the tool does as a whole. It calls it 'global legislative intelligence' but does not differentiate it from sibling tools like legalpulse or taxpulse, making it vague.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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. The description lists endpoints but does not explain when to choose each, nor does it mention when not to use the tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
proppulseAInspect
PropPulse: Global real estate intelligence API — 10 endpoints covering the full property lifecycle. Mortgage analysis (with Rocket Mortgage/LendingTree/Better lender links), affordability, rent-vs-buy modeling,
Coverage: Global
Endpoints: • mortgage ($0.10): Mortgage analysis — current rates, payment breakdown, max price, lender links • afford ($0.10): True affordability analysis — stress-free vs. bank-qualifying ceiling • rentbuy ($0.10): Rent vs. buy decision model — break-even, 5-year wealth comparison, recommendation • refi ($0.08): Refinance opportunity analysis — break-even, monthly savings, cash-out potential • market ($0.10): Local market intelligence — buyer/seller conditions, price trends, inventory • invest ($0.15): Investment property ROI — cap rate, cash-on-cash, 5-year projection, investment grade • valuate ($0.10): Property valuation — AVM estimate with comparable sales and negotiation intelligence • neighborhood ($0.10): Neighborhood intelligence — schools, safety, walkability, investment outlook • first-buyer ($0.10): First-time homebuyer guide — all assistance programs, loan types, step-by-step process • landlord ($0.12): Landlord toolkit — rent pricing, tenant screening, lease law, local regulations
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | US zip or country for property tax lookup | |
| beds | No | Bed/bath description (e.g. 3/2) | |
| debt | No | Existing monthly debt payments (car, student loans) | |
| down | No | Down payment in USD. Defaults to 20%. | |
| lang | No | lang | |
| rate | No | Current interest rate as percentage (e.g. 7.25) | |
| rent | No | Current monthly rent in local currency | |
| sqft | No | Square footage (improves estimate) | |
| type | No | single-family / multifamily / condo / short-term | |
| price | No | Purchase price in local currency | |
| units | No | Number of rental units | |
| years | No | Planned years in home. Defaults to 5. | |
| action | Yes | Which endpoint to call. Options: mortgage | afford | rentbuy | refi | market | invest | valuate | neighborhood | first-buyer | landlord | |
| credit | No | Credit score range (e.g. 680) | |
| income | No | Annual gross income | |
| address | No | Full property address (e.g. 123+Main+St+Austin+TX) | |
| balance | No | Remaining loan balance | |
| savings | No | Available savings / potential down payment | |
| location | No | City, state, zip, or country for local context | |
| priority | No | schools / investment / walkability / safety / balanced | |
| situation | No | general / finding-tenants / eviction / raising-rent / maintenance | |
| home_value | No | Current home value (enables cash-out analysis) | |
| years_left | No | Years remaining on current loan. Defaults to 25. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It discloses pricing per endpoint and notes global coverage, but does not detail other behavioral traits like authentication, rate limits, or whether operations are read-only. This is adequate but not comprehensive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately sized and front-loaded with the tool's purpose and coverage. Endpoints are listed in a clear, bullet-like format. However, some redundancy exists (repeating 'Coverage: Global' after listing endpoints) and could be trimmed slightly without losing meaning.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 23 parameters and no output schema, the description provides a high-level understanding of each endpoint's purpose but lacks guidance on which parameters are required for each action. The schema only requires 'action', leaving the agent to infer parameter combinations. Some completeness is sacrificed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 adds no additional parameter semantics beyond what is in the schema; it only summarizes endpoint purposes. No extra meaning or usage context for individual parameters is provided.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Global real estate intelligence API' with 10 endpoints covering the full property lifecycle. Each endpoint is listed with its specific purpose, making the tool's function unambiguous and distinct from sibling tools which are in other domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 proppulse versus alternatives, but the name and content ('real estate intelligence') imply its domain. No direct comparisons or when-not-to-use guidance are provided, leaving the agent to infer based on context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
prospectpulseCInspect
ProspectPulse: Global mineral and resource exploration intelligence. USGS MRDS deposit inventory, geochemical anomaly analysis, satellite scene availability, jurisdiction entry-risk, social license risk, critical mi
Coverage: Global
Endpoints: • mineral-potential ($0.25): Mineral prospectivity assessment • deposit-intel ($0.20): Mineral deposit intelligence • critical-minerals-scan ($0.25): Critical minerals country endowment scan • jurisdiction-entry ($0.25): Exploration jurisdiction entry-risk assessment • satellite-availability ($0.10): Free satellite scene availability + remote sensing guide • geochemical-anomaly ($0.15): USGS geochemical anomaly characterization • social-license-risk ($0.20): Social license risk assessment • commodity-supply-intel ($0.20): Commodity supply/demand intelligence • oil-gas-basin ($0.25): Oil & gas basin analysis • exploration-brief ($0.35): Comprehensive exploration target brief (premium)
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude (decimal degrees) | |
| lon | No | Longitude (decimal degrees) | |
| lang | No | Response language (ISO 639-1) | en | es | fr | pt | ru | zh | id | ar | |
| basin | No | Basin or region | Permian Basin | Santos Basin Brazil | Rovuma Basin | East African Rift | Cooper Basin Australia | Tarim Basin | Barents Sea | Guyana-Suriname | Browse Basin | Namibe Basin Angola | Vaca Muerta Argentina | |
| action | Yes | Which endpoint to call. Options: mineral-potential | deposit-intel | critical-minerals-scan | jurisdiction-entry | satellite-availability | geochemical-anomaly | social-license-risk | commodity-supply-intel | oil-gas-basin | exploration-brief | |
| region | No | Named geological region | Carlin Trend Nevada | Atacama Desert | Abitibi Greenstone Belt | Zambia Copper Belt | Pilbara WA | |
| country | No | Country or region | DRC | Chile | Indonesia | Australia | Greenland | Kazakhstan | Philippines | Argentina | Canada | Zambia | Zimbabwe | Guinea | Papua New Guinea | Brazil | |
| deposit | No | Deposit or mine name | Escondida | Oyu Tolgoi | Kibali | Grasberg | Olympic Dam | Thacker Pass | Jadar | Cobre Panama | |
| project | No | Optional project name | Conga Mine | Pebble Mine | Ajax Mine | New Prosperity | |
| elements | No | Comma-separated elements | Au,As,Sb | Cu,Mo,Au | Ni,Co,Cr | Li,Cs,Rb | |
| location | No | Location | Peru Cajamarca | Pebble Alaska | West Papua Indonesia | Ring of Fire Ontario | Northern BC Canada | Limpopo South Africa | Oaxaca Mexico | |
| commodity | No | Target commodity | gold | copper | lithium | nickel | cobalt | REE | uranium | silver | zinc |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must disclose behaviors. It only mentions endpoint costs and 'Coverage: Global', but lacks details on authentication, rate limits, parameter effects, or side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with a clear summary but includes unnecessary pricing details and is truncated. Structure is adequate but could be more concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (12 parameters, 10 endpoints) and no output schema, the description fails to explain endpoint-specific parameter requirements or return values, leaving the agent under-informed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 adds no new parameter meaning beyond the schema's own descriptions; it only lists endpoints without clarifying which parameters apply to each.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool is for mineral and resource exploration intelligence, listing specific endpoints. It distinguishes from sibling tools by domain, but is slightly cluttered with pricing details.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 (e.g., siblings). No 'when to use' or 'when not to use' context, leaving the agent to infer endpoint selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
racingpulseCInspect
RacingPulse: Global horse racing intelligence — live odds, going conditions, form analysis, arbitrage detection, speed ratings, and betting systems for 35 racecourses. All endpoints require x402 payment (USDC on B
Coverage: Global
Endpoints: • scanner ($0.07): Arbitrage scanner — scan all active racing sports for guaranteed-profit opportunities • arbitrage ($0.07): Live arbitrage — filtered guaranteed-profit opportunities for a specific racing jurisdiction • card ($0.07): Race card — complete meeting briefing with runners, odds, going, and news • going ($0.07): Going conditions — live ground conditions derived from 7-day precipitation data • form ($0.07): Form guide — deep horse form analysis with trainer stats and going preferences • ratings ($0.07): Speed ratings — official rating, RPR, Timeform, and going-adjusted performance ratings • systems ($0.07): Betting systems — statistically-backed angles, trainer/jockey combos, draw bias • trends ($0.07): Race trends — historical patterns, draw bias, trainer records, value and fade angles • track ($0.07): Track profile — complete racecourse intelligence with live going conditions • greyhound-form ($0.07): Greyhound form — recent runs, sectional times, trap record, kennel form, and verdict • greyhound-trap ($0.07): Greyhound trap bias — win rates per trap, rail vs wide advantage, pace profile, and betting angles • greyhound-card ($0.07): Greyhound race card — full field breakdown with trap suitability, value selection, and system plays • calculator ($0.07): Betting calculator — arbitrage stakes (Kelly), expected value, and profit calculations
| Name | Required | Description | Default |
|---|---|---|---|
| dog | No | Greyhound name | |
| date | No | date | |
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| mode | No | mode | |
| odds | No | Comma-separated runner odds e.g. 3.5,2.1 (arb mode) | |
| race | No | Race or meeting name e.g. 'Cheltenham Gold Cup', 'Royal Ascot' | |
| grade | No | Race grade e.g. A1, A2, S2, OR | |
| horse | No | Horse name | |
| sport | No | sport | |
| stake | No | Stake amount (ev mode) | |
| track | No | Track name e.g. ascot, cheltenham, flemington | |
| action | Yes | Which endpoint to call. Options: scanner | arbitrage | card | going | form | ratings | systems | trends | track | greyhound-form | greyhound-trap | greyhound-card | calculator | |
| filter | No | e.g. 'Ascot sprints', 'novice hurdlers', 'flat handicaps' | |
| regions | No | regions | |
| trainer | No | Trainer name (optional) | |
| bankroll | No | Total bankroll (arb mode) | |
| distance | No | Race distance e.g. 400m, 460m, 520m | |
| true_prob | No | Your estimated true win probability 0-1 (ev mode) | |
| min_profit | No | Minimum profit % filter | |
| single_odds | No | Decimal odds for single selection (ev mode) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It mentions a payment requirement and coverage, but lacks disclosure on rate limits, authentication details, data freshness, or consequences of errors. Behavioral traits beyond the basic endpoints are absent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is verbose and includes pricing and coverage details upfront before listing endpoints. While it is structured as a list, the initial sentences could be more concise. The length is not excessive, but some information could be shortened or moved to annotations.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (20 parameters, multiple endpoints, no output schema), the description lacks usage examples, parameter dependencies, and response information. It provides endpoint purposes but not enough to fully understand how to construct requests or interpret results.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, but parameter descriptions are minimal (e.g., 'regions', 'date', 'mode'). The tool description adds context by listing endpoints and some parameter examples, but does not sufficiently explain parameter relationships or advanced usage. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool is for global horse racing intelligence, listing many specific endpoints that cover odds, form, betting systems, etc. It differentiates from siblings by focusing on racing, but the purpose is somewhat cluttered with pricing and an extensive endpoint list.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 versus alternatives. The description mentions payment requirements but does not provide context for selecting among the many actions or comparing with sibling tools. Usage is implied but not clarified.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
remittancepulseBInspect
RemittancePulse: Global remittance intelligence API covering the $700B+ annual global remittance market. 8 endpoints: corridor analysis (200+ corridors), provider comparison with true total cost (fee + FX markup), liv
Coverage: Global
Endpoints: • corridor ($0.08): Corridor intelligence • compare ($0.10): Provider comparison • rate ($0.05): FX rate and markup analysis • receive ($0.08): Receive-country guide • mobile ($0.08): Mobile money ecosystem • compliance ($0.10): Compliance and KYC intelligence • news ($0.08): Remittance industry news • diaspora ($0.10): Diaspora community intelligence
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Receiving country — e.g. Philippines, India, Mexico, Nigeria, Bangladesh | |
| from | No | Sending country — e.g. USA, UAE, UK, Canada, Germany | |
| lang | No | lang | |
| topic | No | regulatory | providers | fees | technology | all | |
| action | Yes | Which endpoint to call. Options: corridor | compare | rate | receive | mobile | compliance | news | diaspora | |
| amount | No | Amount to send in source currency | |
| method | No | bank | cash | mobile | wallet — or omit for all methods | |
| region | No | East Africa | West Africa | South Asia | Southeast Asia | Latin America | Middle East | |
| country | No | country | |
| purpose | No | purpose | |
| platform | No | Specific platform — e.g. M-Pesa, GCash, bKash | |
| community | No | e.g. Filipino, Indian, Mexican, Nigerian, Pakistani, Bangladeshi, Vietnamese | |
| to_currency | No | e.g. PHP, INR, MXN, NGN, PKR | |
| sending_from | No | Country sending from — tailors corridor-specific advice | |
| from_currency | No | e.g. USD, GBP, EUR, AED, CAD |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses per-endpoint costs, which is a behavioral trait. However, no annotations exist, and the description omits other important behaviors such as authentication, rate limits, error handling, or idempotency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is reasonably concise, front-loading the main purpose. The bullet list of endpoints is efficient, though the truncation and lack of clear separation between description sections slightly disrupt structure.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description does not explain return values (no output schema), nor does it clarify how the action parameter selects among endpoints. It is incomplete for a multi-endpoint tool, leaving key usage context missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the schema already describes parameters adequately. The description lists endpoint names but does not add meaning beyond the schema, such as parameter combinations or usage constraints.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies the tool as a global remittance intelligence API and lists its endpoints with brief purposes. However, it does not explicitly distinguish this tool from sibling tools that may also be data APIs, and the truncation slightly reduces clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 sibling tools. There is no mention of when-not-to-use or alternatives, leaving the agent without context for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
riskpulseAInspect
RiskPulse: Global risk intelligence API. AI-synthesized travel safety alerts, country risk profiles, sanctions screening, business risk analysis, supply chain disruption intelligence, nomad visa/tax guidance, ex
Coverage: Global
Endpoints: • country ($0.10): Country risk profile • travel ($0.08): Travel safety assessment • business ($0.10): Business risk analysis • compare ($0.10): Country risk comparison • expat ($0.10): Expat living guide • alerts ($0.10): Situational security alerts • evac ($0.10): Evacuation plan • nomad ($0.10): Digital nomad score • sanctions ($0.15): Sanctions exposure analysis • supply ($0.15): Supply chain risk
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City | |
| from | No | Country of origin (default: US) | |
| lang | No | lang | |
| action | Yes | Which endpoint to call. Options: country | travel | business | compare | expat | alerts | evac | nomad | sanctions | supply | |
| entity | No | Entity name | |
| country | No | Country name (e.g. Mexico, Thailand, Nigeria) | |
| product | No | Product or component | |
| industry | No | industry | |
| location | No | Location | |
| countries | No | Comma-separated country names (e.g. Mexico,Colombia,Costa Rica) | |
| entity_type | No | Entity type (person, company, vessel) | |
| nationality | No | Traveler nationality (default: US) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must cover behavioral traits. It mentions 'AI-synthesized' data and global coverage, but lacks details on authentication, rate limits, or whether operations are read-only. The endpoint list gives some structure but not full behavioral transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is relatively long and includes pricing details that may be extraneous for an AI agent. While structured, it could be more concise by focusing on core functionality rather than costs.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite no output schema and 12 parameters, the description covers the main endpoints and their purposes (country profile, travel assessment, etc.), providing sufficient context for an AI agent to understand the tool's offerings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, meaning the schema already documents all 12 parameters. The description adds endpoint context and pricing, but no additional parameter semantics beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states that RiskPulse is a global risk intelligence API with specific endpoints for travel safety, country profiles, sanctions, etc. This distinguishes it from sibling tools like climatepulse or cryptopulse, which focus on different domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for risk intelligence queries via the listed endpoints, but does not explicitly compare to alternatives or state when not to use. The sibling tools are for other domains, so context is clear but exclusions are missing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
safepulseBInspect
SafePulse: SafePulse — product safety intelligence: CPSC, FDA, USDA FSIS, NHTSA recalls; EU RAPEX; home safety scores; child/vehicle safety ratings; food safety alerts worldwide.
Coverage: Global
Endpoints: • recall ($0.08): Active recall dashboard • product ($0.08): Consumer product safety • vehicle ($0.10): Vehicle safety • food ($0.08): Food and drug recall • home ($0.10): Home safety hazards • child ($0.10): Child product safety • score ($0.12): Brand safety score • eu ($0.08): EU Safety Gate alerts • global ($0.10): Global safety alerts
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | lang | |
| make | No | make | |
| room | No | kitchen | bedroom | bathroom | garage | nursery | |
| type | No | type | |
| year | No | year | |
| brand | No | brand | |
| model | No | model | |
| action | Yes | Which endpoint to call. Options: recall | product | vehicle | food | home | child | score | eu | global | |
| region | No | canada | australia | uk | who | global | |
| country | No | Filter by EU country (e.g. Germany, France, Spain) | |
| product | No | product | |
| category | No | Filter by recall category | |
| age_group | No | infant | toddler | preschool | school-age | |
| product_type | No | product_type |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full burden. It discloses costs per endpoint and global coverage, but does not mention authentication requirements, rate limits, or confirm read-only behavior. The implied read-only nature is clear from 'safety intelligence', but explicit behavioral traits are missing.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with a clear purpose and structured with a bullet list of endpoints. However, it includes redundant pricing details and is somewhat verbose. Every sentence earns its place, but could be more concise without losing clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (14 parameters, no output schema), the description lacks information about what each endpoint returns, how results are formatted, or pagination. It only hints at output through endpoint names. This is insufficient for an agent to understand the full context of tool usage.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description adds some context for the 'action' parameter by listing endpoint names, but most parameter descriptions in the schema are terse (e.g., 'lang', 'make') and the tool description does not elaborate on their meaning. It adds marginal value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it provides product safety intelligence with specific data sources (CPSC, FDA, etc.) and lists nine distinct endpoints. It differentiates from sibling tools by focusing on safety, though sibling names imply specialized domains. The verb 'delivers' is implicit, and the resource is well-defined.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explains each endpoint's purpose (e.g., 'recall: Active recall dashboard') and price, giving context for when to use which. However, it does not provide explicit when-to-use vs. alternatives or when not to use the tool. No comparison to sibling tools or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
scholarpulseCInspect
ScholarPulse: Global scholarship and student finance intelligence. 12 endpoints covering scholarship search (190+ countries), international scholarship matching, government programs, Erasmus+, US financial aid (Col
Coverage: Global
Endpoints: • search ($0.15): Scholarship search • global ($0.15): International scholarship matching • government ($0.10): Government scholarship programs • erasmus ($0.08): Erasmus+ program guide • aid ($0.12): US financial aid estimate • fafsa ($0.10): FAFSA strategy • loans ($0.12): Student loan repayment strategy • forgiveness ($0.10): Loan forgiveness eligibility • roi ($0.10): Degree ROI analysis • merit ($0.12): Merit aid strategy • deadline ($0.08): Scholarship deadline tracker • essay ($0.10): Scholarship essay strategy
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Host country | |
| gpa | No | GPA (e.g. 3.8) | |
| debt | No | Total expected debt at graduation | |
| from | No | Home EU/EEA country | |
| lang | No | Response language (default: English) | |
| year | No | freshman | sophomore | junior | senior | graduate | |
| field | No | Field of study | |
| level | No | Education level | |
| major | No | Field of study (e.g. nursing, engineering, computer-science) | |
| month | No | next | this-month | next-3-months | |
| state | No | US state for state-specific programs | |
| action | Yes | Which endpoint to call. Options: search | global | government | erasmus | aid | fafsa | loans | forgiveness | roi | merit | deadline | essay | |
| assets | No | Reportable assets (exclude retirement accounts) | |
| income | No | Household income for need-based filtering | |
| prompt | No | The essay prompt text | |
| balance | No | Total loan balance | |
| college | No | US college or university name | |
| country | No | Country to search in (default: US) | |
| duration | No | Duration in months (2-12) | |
| loan_type | No | federal | private | HELP | Plan2 | OSAP | |
| background | No | Brief student background | |
| profession | No | teacher | nurse | doctor | social-worker | lawyer | military | government-employee | researcher | veterinarian | |
| test_score | No | SAT 1400 | ACT 32 | IB 38 | |
| word_limit | No | Word limit | |
| demographic | No | first-gen | veteran | international | stem-women | |
| destination | No | Target country (e.g. UK, Germany, USA, Japan) | |
| family_size | No | Household size (default: 4) | |
| nationality | No | Student's nationality (e.g. Indian, Nigerian, Brazilian) | |
| scholarship | No | Scholarship name (e.g. Gates Scholarship, Chevening, DAAD, Rhodes) | |
| degree_level | No | bachelor | master | phd | associate | professional | |
| employer_type | No | public-school | nonprofit | government | private | |
| years_in_service | No | Years in qualifying employment | |
| dependency_status | No | Dependency status | |
| years_in_repayment | No | Years already in repayment |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses pricing per endpoint but does not mention idempotency, rate limits, authentication, or whether the tool creates side effects. The listing of endpoints implies read operations, but this is not explicitly stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is verbose and unstructured, mixing bold text, a brief coverage line, and a bullet list of endpoints with prices. It lacks a coherent narrative and repeats 'Endpoints:' unnecessarily. It could be more concise and organized.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 34 parameters and 12 endpoints, the description is incomplete. It does not explain how parameters map to actions, provide example usage, or describe return values (no output schema). The description fails to equip the agent with enough context to invoke the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with each parameter described, but the description adds no value by linking parameters to specific actions. For example, 'to' and 'from' might be relevant only for 'erasmus', but this is not clarified. The flat schema with many optional parameters is not explained.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the tool is for global scholarship and student finance intelligence, listing 12 endpoints. It clearly identifies the domain and distinguishes from sibling 'pulse' tools. However, it doesn't succinctly state that the tool acts as a router based on the 'action' parameter.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 (siblings like 'grantpulse' or 'edupulse'). The description lists endpoints but doesn't provide criteria for selecting one endpoint over another or explain when not to use the tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
seniorpulseBInspect
SeniorPulse: Global elder care intelligence API. AI-synthesized Medicare guidance, care facility evaluation, medication safety, benefits discovery, and caregiver support for seniors and their families worldwide. U
Coverage: Global
Endpoints: • medicare ($0.15): Medicare plan guidance • facility ($0.15): Care facility evaluation guide • meds ($0.10): Medication safety check for elderly patients (polypharmacy) • benefits ($0.10): Benefits eligibility assessment (US) • caregiver ($0.10): Family caregiver resource guide • grief ($0.10): Post-loss estate and grief guide • legal ($0.10): Elder law document guide (POA, advance directive, guardianship) • memory ($0.10): Cognitive decline staging and dementia care trajectory • nh-compare ($0.15): Nursing home quality comparison (CMS Care Compare data) • property-tax ($0.08): Senior property tax relief programs by state • rx-assist ($0.10): Prescription assistance programs (Extra Help, state programs, pharma PAPs) • snap-utility ($0.10): Senior SNAP food assistance and LIHEAP utility assistance • veterans ($0.15): VA Aid & Attendance and senior veteran benefits
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Patient age — used to calibrate Beers Criteria thresholds (most critical for ages 65–75 vs. 85+) | |
| zip | No | ZIP code for plan availability context (US) | |
| lang | No | Response language (e.g. 'es', 'zh', 'ko', 'vi', 'tl') — Claude responds natively in any language | |
| type | No | Facility type. Defaults to assisted-living. | |
| state | No | US state name or 2-letter abbreviation (e.g. 'Texas', 'TX') | |
| action | Yes | Which endpoint to call. Options: medicare | facility | meds | benefits | caregiver | grief | legal | memory | nh-compare | property-tax | rx-assist | snap-utility | veterans | |
| assets | No | Total countable assets in USD — excludes primary home and one vehicle | |
| budget | No | Monthly budget in local currency (USD for US, GBP for UK, AUD for Australia, CAD for Canada) | |
| income | No | Monthly gross income in USD (Social Security, pension, wages) | |
| has_poa | No | Whether an existing POA is in place — affects urgency and next steps | |
| veteran | No | Set true to include VA Aid & Attendance and other veteran-specific benefits in the assessment | |
| location | No | City and state/country (e.g. 'Austin TX', 'London UK', 'Toronto Canada', 'Sydney Australia') | |
| own_home | No | Whether the senior owns their home — affects LIHEAP eligibility and some SNAP asset tests | |
| care_cost | No | Monthly unreimbursed care costs in USD (home health aide, assisted living, adult day care) | |
| cdr_score | No | Clinical Dementia Rating (0, 0.5, 1, 2, 3). 0=normal, 0.5=very mild, 1=mild, 2=moderate, 3=severe. | |
| diagnosis | No | Formal diagnosis if known (e.g. 'Alzheimer's', 'vascular dementia', 'Lewy body', 'MCI', 'frontotemporal') | |
| situation | No | Enrollment scenario — e.g. 'turning 65', 'comparing plans', 'losing employer coverage at 67', 'enrolling due to disability', 'reviewing Part D' | |
| days_since | No | Days since the loss — calibrates guidance to immediate (0–7 days), short-term (1–4 weeks), or ongoing estate (1–12 months) phases | |
| facilities | No | Comma-separated facility names or addresses to compare head-to-head (e.g. 'Sunrise Senior Living Austin,Brookdale South Austin') | |
| home_value | No | Estimated home value in USD — used to estimate annual savings | |
| mmse_score | No | Mini-Mental State Examination score (0–30). 24–30 normal, 18–23 mild, 0–17 severe. | |
| moca_score | No | Montreal Cognitive Assessment score (0–30). Below 26 indicates possible impairment. | |
| medications | No | Comma-separated medication list using generic names (e.g. 'metformin,lisinopril,aspirin,diphenhydramine,amlodipine') | |
| on_medicare | No | Whether the senior is enrolled in Medicare Part D — affects Extra Help vs. manufacturer PAP eligibility | |
| veteran_age | No | Veteran age | |
| current_living | No | Current living situation (e.g. 'alone', 'with spouse', 'with adult children', 'assisted living') | |
| household_size | No | Number of people in the household — SNAP limits vary by household size | |
| capacity_concern | No | Set true if there are concerns about the senior's cognitive capacity to sign legal documents — triggers guardianship guidance | |
| medical_expenses | No | Monthly out-of-pocket medical expenses — seniors can deduct excess medical costs to qualify for SNAP | |
| surviving_spouse | No | Set true if the applicant is a surviving spouse of a veteran — unlocks Survivors Pension and Aid & Attendance for surviving spouses |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. The description mentions endpoints and prices, implying a paid API, but does not disclose data sources, latency, or side effects. Some transparency is present through the endpoint list, but lacking for a complete behavioral picture.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is verbose, contains formatting issues (cut off text, stray 'U'), and repeats the tool name. It could be significantly streamlined.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description does not explain the overall workflow (action dispatch), what the API returns, or how to handle the 30 parameters. It is incomplete and lacks guidance for effective use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description adds endpoint names and brief purposes, but this largely overlaps with the schema's enum description for 'action'. Marginal value beyond schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool provides 'AI-synthesized Medicare guidance, care facility evaluation, medication safety, benefits discovery, and caregiver support for seniors' and lists specific endpoints. It distinguishes from sibling tools by focusing on elder care.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 sibling tools like vetpulse or legalpulse. The description lists endpoints but does not provide alternative tools or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
signalpulseCInspect
SignalPulse: Institutional-grade trading & prediction-market intelligence for agents. Calibrated multi-engine reads across crypto, FX, macro-events, prediction markets (Polymarket/Kalshi/Manifold/PredictIt) and sports — de-vigged sportsbook consensus plus proprietary xG/EPA/Statcast/weather analytics. Agent analysis tier; the curated, sized, tracked calls are the premium service.
Coverage: Global
Endpoints: • sample (FREE): FREE pick-of-the-day — a full-depth sample of SignalPulse's sports intelligence on one featured matchup (de-vigged sportsbook consensus + proprietary stats/weather analytics). No payment, no API key. • game ($1.00): Deep single-match analysis for AI sports & research agents — a full multi-engine read of any game: de-vigged sportsbook consensus (Bovada/FanDuel/Pinnacle), sharp-line moves, proprietary xG/EPA/Statcast/map-pool analytics, venue weather and altitude physics, injuries and props. Returns 3 ranked +EV plays with full reasoning, props included. • predmarket ($2.00): Calibrated superforecaster scan of prediction markets for AI research & trading agents — a base-rate-anchored read across Polymarket, Kalshi, Manifold and PredictIt: cross-venue divergence, order-book and whale flow, and for sports the de-vigged sportsbook consensus plus proprietary team-strength and weather engines. Returns mispriced markets with probabilities, edge and full commentary, props included. • racing ($0.50): Today's GB/IRE racing card scanned for AI betting & research agents — the single highest expected-value selection plus value picks across every race, horse or greyhound. Horses: RPR/Topspeed, draw bias, pace shape, going×form and trainer/jockey conditional course/going records. Greyhounds: early-speed, trap affinity, overall run-time, track trap-bias. Live exchange + forecast prices give genuine EV. • h2h ($0.50): Player head-to-head for AI betting & research agents — a targeted read of TWO named players against each other in any matchup sport (golf, tennis, MMA). Returns the betting matchup verdict (favoured side, EV, edge) AND the fantasy head-to-head (who scores more DFS/fantasy points), plus data-backed props. • compare ($1.00): Compare & rank 2+ named players against each other for AI betting, fantasy & research agents — golf 3-balls, DFS player pools, season-long start/sit, 'best of these'. Returns a ranked list (each with a projection) plus the single best betting play AND the best fantasy/DFS value. • fantasy ($1.00): Direct fantasy advice for AI agents — start/sit, DFS lineup (salary cap, points-per-dollar), waiver pickups and trade analysis. FULLY OPEN: returns committed recommendations (who to start, accept/decline the trade), not just analysis. Projects fantasy points from the underlying data (golf SG/course-fit; NFL/MLB/NBA usage/role/matchup); the betting market is optional, never the gate. • player ($0.50): Single-player stat-projected outlook for AI betting, fantasy & research agents — data-backed prop projections (the stat is projected from the underlying data even when no book posts a line), the fantasy projection (points, floor/ceiling, start-worthiness) and the form/role/matchup read. Golf strokes-gained/course-fit; NFL/MLB/NBA usage/role/matchup. • ask ($1.00): Ask any sports or prediction-market question in plain language — the front door to SignalPulse's deep engines. Returns a data-grounded answer with an explicit DATA-vs-OPINION split (every claim cites its stat; judgment is labeled), a betting or fantasy angle when relevant, and a pointer to the deepest named endpoint. Honest when a question is outside coverage — it routes, it doesn't bluff. • golf ($1.00): Whole-field golf scan for AI betting, fantasy & research agents — reads the ENTIRE tournament field (PGA ShotLink strokes-gained + ESPN) and surfaces the single highest-EV play across every bet type (outright / each-way / top-N / matchup / make-cut / first-round-leader), led by course-fit and the tee-time weather wave. For named golfers use /api/scan/compare or /api/scan/h2h. • crypto ($2.00): Institutional-grade crypto market scan for AI financial & trading agents — 40+ live intelligence layers (regime, breadth, on-chain cycle, derivatives positioning, funding extremes, liquidation context, ETF/stablecoin flows) synthesized into a decision-ready read: directional bias, confidence, full rationale, key factors, adversarial pre-mortem. • market ($2.00): Institutional cross-asset market scan for AI financial & trading agents — multi-layer read across FX majors, metals, and equity indices: regime, COT positioning, yield spreads, carry, real yields, VIX term structure, options gamma, and macro, synthesized into a decision-ready read: best instrument, directional bias, confidence, full rationale, key factors. • forex ($0.50): Institutional forex market scan for AI financial & trading agents — multi-layer read across the 28 majors and crosses: rate differentials, COT positioning, carry, policy divergence, yield spreads, and cross-asset macro regime, synthesized into a decision-ready read: best pair, directional bias, confidence, full rationale, key factors. • event ($1.00): Institutional economic-event scan for AI financial & trading agents — historical-reaction study for a scheduled macro release (NFP, CPI, FOMC and more): how the affected FX pairs have moved after similar surprises, the surprise read, macro context, and which pair has the cleanest reaction profile, with directional bias, confidence, and full rationale. • options ($0.50): Institutional equity-options volatility scan for AI financial & trading agents — VRP (variance risk premium), IV term structure, GEX regime, max-pain and unusual options activity across liquid optionable names, synthesized into a decision-ready read: best ticker, vol/directional bias, confidence, full rationale, key factors. • futures ($0.50): Institutional futures market scan for AI financial & trading agents — multi-layer read across the futures complex (equity index, rates, energy, metals, grains): COT positioning (disaggregated + financial), seasonality, term structure, and macro regime, synthesized into a decision-ready read: best contract, directional bias, confidence, full rationale, key factors.
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | A free-text sports/markets question (aliases: question, ask). | |
| get | No | Trade mode — player(s) you would receive. | |
| give | No | Trade mode — player(s) you would send. | |
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| mode | No | The fantasy decision type. | |
| type | No | Race discipline to scan (default horse). | |
| event | No | Matchup hint, e.g. yankees-red-sox. | |
| slots | No | Optional — how many to start (start-sit / lineup). | |
| sport | No | mlb | nba | nfl | nhl | wnba | soccer_epl | tennis | mma | esports … | |
| style | No | Scan horizon | |
| action | Yes | Which endpoint to call. Options: sample | game | predmarket | racing | h2h | compare | fantasy | player | ask | golf | crypto | market | forex | event | options | futures | |
| market | No | Optional focus (hint, not a cap). | |
| player | No | A single player name. | |
| horizon | No | short: order-flow/dislocation. mid: positioning + catalyst. long: base-rate/calibration. | |
| players | No | 2–12 names — a-vs-b-vs-c, comma-separated, or repeated ?player=. | |
| scoring | No | Optional scoring format. | |
| category | No | Prediction-market category to scan. | |
| player_a | No | First player (or use players=a-vs-b). | |
| player_b | No | Second player. | |
| strategy | No | Strategy filter | |
| market_type | No | Optional market focus (hint, not a cap). | |
| signal_type | No | Options horizon |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must disclose all behavioral traits. It mentions pricing but not how payment works, no rate limits, authentication, or data freshness. Critical details like cost implications and endpoint-specific return formats are omitted.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely long and poorly structured—a wall of text listing endpoints. It is not front-loaded with essential information for an AI agent, and the dense bullet format is not concise or easily digestible.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (22 parameters, no output schema, no annotations), the description is incomplete. It lacks explanation of return formats, error handling, parameter combination rules, and the fact that this is a paid API with varying costs per action.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description adds value for the 'action' parameter by detailing each endpoint, but other parameters like 'q', 'mode', 'sport' are not elaborated beyond the schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states it is 'Institutional-grade trading & prediction-market intelligence for agents' and lists many endpoints, but the overall purpose as a unified query tool is not succinctly captured. The variety of endpoints obscures a single clear verb+resource.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Extensive guidance is given on when to use each endpoint within the tool, but there is no comparison or exclusion with sibling tools like alphapulse or marketpulse, leaving the agent unsure of when to choose this tool over others.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
stateedgeAInspect
StatEdge: Global sports analytics and intelligence API. AI-synthesized injury reports, ATS/spread analysis, matchup predictions, odds analysis, parlay optimization, referee tendency analysis, rest/travel advant
Coverage: Global
Endpoints: • odds ($0.10): Live betting odds consensus • injuries ($0.08): Injury report with fantasy and betting impact • matchups ($0.10): Matchup analysis for fantasy and betting • waiver ($0.10): Fantasy waiver wire recommendations • recap ($0.08): Post-game recap with fantasy and betting implications • global ($0.10): Global sports intelligence — F1, cricket, rugby, tennis, AFL, golf, boxing, MMA, cycling • ats ($0.10): Against-the-spread trends • parlay ($0.10): Parlay analysis and probability • ref-analysis ($0.10): Referee and official tendencies • rest ($0.08): Rest and schedule advantage analysis • injury-impact ($0.08): Single player injury impact analysis
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Referee name (optional — analyzes general tendencies if omitted) | |
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| legs | No | Comma-separated parlay legs (e.g. Chiefs -3,Over 47.5,Lakers ML) | |
| team | No | Team name (e.g. Lakers, Chiefs, Arsenal, Mumbai Indians) | |
| week | No | Week number (NFL/NCAAF only) | |
| sport | No | Sport or league code. Global coverage: EPL/LALIGA/BUNDESLIGA/SERIEA/LIGUE1/UCL for European soccer; AFL/NRL/NBL for Australia; SIXNATIONS/NRL for rugby; F1 for Formula 1; CRICKET_IPL/CRICKET_BBL for cricket. | |
| action | No | F1: race|standings|qualifying|calendar. Cricket: match|series|ipl|standings. Rugby: match|tournament|standings. Tennis: tournament|rankings|draw|match. Others: preview|results|standings|analysis. | |
| detail | No | Optional context: tournament name, team name, matchup, series. E.g. 'Six+Nations', 'Wimbledon', 'England+vs+Australia', 'Masters' | |
| player | No | player | |
| opponent | No | opponent | |
| situation | No | The situation to analyze (e.g. home-underdog, divisional, off-a-loss, primetime) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral disclosure burden. It mentions endpoint costs and global coverage, which are helpful. However, it lacks details on authentication, rate limits, error handling, or what happens when invalid parameters are passed. The description adds some value beyond the schema but is not exhaustive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the main purpose and then structured as a bullet list of endpoints, which is easy to scan. Though it is somewhat lengthy, every sentence provides useful information about available endpoints and costs. It could be more concise but is well-organized.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 11 parameters and no output schema, the description should provide more context on how parameters map to endpoints and what outputs to expect. Currently, the description lists endpoints but does not explain how to combine parameters (e.g., which parameters are needed for a specific endpoint). This gap limits the agent's ability to use the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 11 parameters clearly. The tool description does not add significant extra meaning beyond what the schema provides; it repeats some parameter names but no new semantics. Baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly identifies stateedge as a global sports analytics API, listing specific endpoints (odds, injuries, matchups, etc.) with brief descriptions. This provides a specific verb-resource pair and distinguishes it from sibling tools which are non-sports pulse tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists endpoints with costs and brief descriptions but does not provide explicit guidance on when to use stateedge versus sibling tools (which are unrelated domains) or how to select among endpoints for a given query. The sibling differentiation is implicit by domain, but within the tool, no decision support is given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
talentpulseBInspect
TalentPulse: Global workforce intelligence API — salary benchmarks, remote compliance, EOR cost models, skills demand, work visas, talent market analysis, executive compensation, layoff tracking, skills gap analys
Coverage: Global
Endpoints: • salary ($0.15): Salary benchmarking — any role, any location globally • remote-compliance ($0.20): Remote work compliance — jurisdiction-specific legal intelligence • employer-of-record ($0.20): Employer of record cost model — full employer cost breakdown by country • skills-demand ($0.12): Skills demand intelligence — real-time market signal for any skill or role globally • visa ($0.15): Work visa intelligence — all pathways for any nationality/destination pair • talent-market ($0.15): Talent market intelligence — supply/demand dynamics, hubs, and competitive landscape • compensation ($0.25): Executive compensation benchmarking — total comp for senior and C-suite roles globally • layoffs ($0.10): Layoff tracker — real-time workforce reduction intelligence • skills-gap ($0.15): Skills gap intelligence — where employer demand outpaces supply, with reskilling pathways • cost-comparison ($0.20): Multi-country hiring cost comparison — CFO-grade employer cost model across countries
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Response language: en | es | fr | de | ja | zh | ko | pt | ar | hi (default: en) | |
| role | No | Job title e.g. Software Engineer | Data Scientist | Product Manager | Registered Nurse | |
| level | No | Level: C-suite | VP | Director | Senior Director | SVP (default: VP) | |
| action | Yes | Which endpoint to call. Options: salary | remote-compliance | employer-of-record | skills-demand | visa | talent-market | compensation | layoffs | skills-gap | cost-comparison | |
| region | No | Geographic focus e.g. Southeast Asia | Europe | North America | MENA | Latin America | Global (default: Global) | |
| salary | No | Annual gross salary in local currency (optional, for cost model) | |
| sector | No | Industry sector e.g. SaaS | fintech | healthcare | manufacturing | consulting (default: technology) | |
| skills | No | Skills or role e.g. machine learning | React | Kubernetes | product management | |
| country | No | Country name — optional, inferred from location if omitted | |
| currency | No | Preferred currency code e.g. USD | GBP | EUR | SGD | INR | AUD | CAD | |
| industry | No | Industry sector e.g. tech | finance | retail | healthcare | media | logistics (default: tech) | |
| location | No | City or region e.g. London | Singapore | São Paulo | Dubai | Bangalore | Toronto | |
| countries | No | Comma-separated list of countries (min 2) e.g. USA,India,Poland,Colombia | |
| experience | No | Experience filter (default: all) | |
| destination | No | Country where they want to work e.g. Canada | Germany | UAE | Australia | UK | Singapore | |
| nationality | No | Nationality of the remote employee (optional) | |
| company_size | No | startup | series-b | mid-market | large-cap | public (optional) | |
| company_country | No | Where the employer entity is based (optional, affects PE analysis) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description should disclose behavioral traits. It lists endpoint costs but omits details on authentication, rate limits, data freshness, or side effects. The tool is likely read-only, but not stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a summary and bulleted endpoints, but it is relatively long. It front-loads the purpose and uses clear formatting, though some repetition exists.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 18 parameters and no output schema, the description adequately covers the endpoint purposes and required parameters. However, it lacks details on return values or how to interpret results, which would aid agent understanding.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 18 parameters. The description adds no additional parameter context or meaning beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a global workforce intelligence API, lists 10 specific endpoints with their purposes and costs, and distinguishes itself from siblings by being focused on workforce data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage by describing each endpoint's function, but does not explicitly guide when to use this tool versus sibling tools or when not to use it. There is no exclusion or alternative guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
taxpulseAInspect
TaxPulse: Global tax intelligence API. AI-synthesized tax guidance for 195 countries: income tax rates, VAT/GST, corporate tax, capital gains, crypto tax treatment, expat tax obligations, digital nomad tax stru
Coverage: Global
Endpoints: • country ($0.10): Country tax system overview • compare ($0.12): Multi-country tax comparison • nomad ($0.12): Digital nomad tax optimization • treaty ($0.12): Tax treaty analysis • structure ($0.15): Corporate tax structuring • crypto ($0.12): Cryptocurrency tax by jurisdiction • expat ($0.12): Expat tax obligations • vat ($0.10): Global VAT/GST intelligence
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | lang | |
| focus | No | focus | |
| action | Yes | Which endpoint to call. Options: country | compare | nomad | treaty | structure | crypto | expat | vat | |
| assets | No | assets | |
| sector | No | digital_services | SaaS | ecommerce | physical_goods | professional_services | |
| country | No | Country name — e.g. Germany, UAE, Portugal, Singapore | |
| activity | No | trading | hodling | staking | mining | DeFi | NFT | all | |
| country1 | No | country1 | |
| country2 | No | country2 | |
| country3 | No | country3 | |
| scenario | No | Profile of interest — e.g. expat individual, digital nomad, holding company, crypto investor | |
| countries | No | Comma-separated list — e.g. Germany,UAE,Portugal | |
| objective | No | e.g. IP holding for SaaS, holding company for investments, minimize corporate tax | |
| situation | No | remote work | retirement | entrepreneur | investor | employment | |
| destination | No | destination | |
| income_type | No | remote employee | freelancer | entrepreneur | investor | content creator | |
| nationality | No | e.g. American, British, Canadian, German — affects home country obligations | |
| income_level | No | income_level | |
| shareholders | No | Shareholder nationalities — affects CFC rules | |
| business_type | No | technology | ecommerce | financial | media | manufacturing | consulting | |
| jurisdictions | No | Preferred jurisdictions — e.g. Netherlands,Luxembourg,UAE | |
| annual_revenue | No | annual_revenue | |
| transaction_type | No | dividends | interest | royalties | capital_gains | employment | pension | all |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. The description mentions AI-synthesized guidance and costs per endpoint, but does not disclose authorization needs, rate limits, or data freshness. Basic transparency but not comprehensive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a summary, coverage, and bulleted endpoints. It front-loads key info, though some repetition (e.g., 'Coverage: Global') and length could be slightly trimmed.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 23 parameters, no output schema, and no annotations, the description does not fully explain which parameters apply to which endpoints or provide usage examples. Critical gaps for effective tool invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, but many parameter descriptions are minimal (e.g., 'lang' and 'assets' just repeat names). Some parameters like 'sector' and 'activity' have enum values that add clarity. Description adds some value beyond schema but not uniformly.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a 'Global tax intelligence API' and lists specific endpoints (country, compare, nomad, etc.), making its purpose distinct from sibling tools which are unrelated topics like alphapulse, arbipulse.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage through endpoint descriptions and costs, but lacks explicit guidance on when to choose this tool over siblings or when to use specific endpoints. No when-not or alternative tools mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
tradepulseCInspect
TradePulse: Global trade intelligence API. AI-synthesized tariff rates, HS code classification, FTA duty analysis, landed cost calculation, trade compliance guidance, sanctions screening, market entry analysis, a
Coverage: Global
Endpoints: • classify ($0.15): HS code classification • tariff ($0.12): Tariff rates by HS code and country pair • landed ($0.15): Full landed cost calculator • fta ($0.15): Free Trade Agreement analyzer • sanctions ($0.12): Sanctions and trade restrictions screening • market ($0.15): Market entry intelligence • compliance ($0.15): Export compliance — EAR/ITAR/dual-use • freight-rates ($0.10): Live freight rate intelligence by lane • nearshore ($0.20): Nearshoring and reshoring advisor • supplier-risk ($0.15): Supplier country risk — UFLPA, ESG, and geopolitical • incoterms ($0.10): Incoterms 2020 decoder • news ($0.08): Trade policy intelligence
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Response language code (en, zh, ja, de, fr, es, ar, hi, etc.) | |
| mode | No | ocean | air | both (default: ocean) | |
| term | No | Incoterms 2020 rule — EXW | FCA | FAS | FOB | CFR | CIF | CPT | CIP | DAP | DPU | DDP | |
| topic | No | tariffs | fta | sanctions | wto | supply-chain | all | |
| value | No | Declared customs value in USD | |
| action | Yes | Which endpoint to call. Options: classify | tariff | landed | fta | sanctions | market | compliance | freight-rates | nearshore | supplier-risk | incoterms | news | |
| checks | No | forced_labor | esg | sanctions | geo_risk | all (default: all) | |
| entity | No | Company or individual name to screen | |
| origin | No | Origin port city or country — e.g. Shanghai, Rotterdam, Los Angeles | |
| sector | No | textiles | electronics | food | chemicals | automotive | mining | any (default: any) | |
| country | No | Country to screen — e.g. Russia, Iran, Cuba, Myanmar, Belarus | |
| end_use | No | Stated end-use — affects license requirement | |
| hs_code | No | 6-digit HS code — e.g. 847130, 610910, 090111 | |
| product | No | Natural language product description — e.g. 'laptop computer', 'cotton t-shirts', 'industrial water pump' | |
| end_user | No | End-user type or entity name | |
| industry | No | Industry or product sector — e.g. electronics, textiles, automotive parts | |
| priority | No | cost | risk | speed | balanced (default: balanced) | |
| quantity | No | Number of units (for per-unit cost calculation) | |
| to_country | No | Importing country — e.g. USA, Japan, Germany, Australia. Also accepts 'to' | |
| destination | No | Destination port city or country — e.g. Los Angeles, Hamburg, Sydney | |
| from_country | No | Exporting country — e.g. China, Vietnam, Germany, Mexico. Also accepts 'from' | |
| target_market | No | Primary market you sell into (default: USA) | |
| container_type | No | 20ft | 40ft | 40hc | lcl (default: 40ft) | |
| target_country | No | Target market country. Also accepts 'country' or 'to' | |
| current_country | No | Current manufacturing/sourcing country — e.g. China, India, Bangladesh | |
| transaction_type | No | export | import | investment | service |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description bears full burden. It mentions per-endpoint costs and 'AI-synthesized,' but fails to disclose side effects (e.g., read-only), authentication needs, or data modification behavior. The endpoints seem analytical, but it's not explicit.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is lengthy and includes a truncated first sentence, making it slightly messy. The endpoint list is useful but could be more condensed. Front-loading is moderate; the key idea is present but not optimally structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 26 parameters and no output schema, the description should guide parameter selection per action and explain return values. It does neither. The agent may struggle to determine which parameters are relevant for a given action, reducing completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with detailed parameter descriptions. The description adds some context by listing endpoints with brief explanations, which indirectly clarifies the 'action' parameter. However, it does not add meaning beyond the schema's own descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Global trade intelligence API' and lists many specific trade functions (tariff rates, HS code classification, etc.), making the overall purpose clear. However, the first sentence is truncated and lacks a cohesive statement that this is a unified API routing to multiple endpoints via an 'action' parameter.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 sibling tools (many other 'pulse' tools). The description does not mention prerequisites, limitations, or alternative scenarios. The agent is left to infer usage from the endpoint list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
transitpulseCInspect
TransitPulse: TransitPulse — global public transit intelligence: route reliability, delay prediction, multi-modal trip planning, city transit scores, and commute optimization for 500+ cities worldwide.
Coverage: Global
Endpoints: • status ($0.05): Live Service Status • city ($0.08): City Transit Intelligence Brief • route ($0.08): Route Reliability Analysis • commute ($0.10): Commute Quality Analysis • airport ($0.08): Airport Transit Guide • agencies ($0.05): Transit Agencies Lookup • delays ($0.05): Current Transit Delays • delays-history ($0.08): Historical Delay Patterns • trip ($0.05): Transit Trip Planning • multimodal ($0.10): Multi-Modal Journey Planning • compare ($0.12): City-to-City Transit Comparison • carfree ($0.12): Car-Free Livability Score • visitor ($0.08): First-Timer Visitor Guide • coverage ($0.10): Transit Coverage Analysis
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Destination neighborhood or address | |
| city | No | City name (e.g. London, NYC, Tokyo) | |
| from | No | Origin neighborhood or address | |
| lang | No | Response language code (en | es | fr | de | zh | hi | ar | pt | ja | ko | etc.) | |
| line | No | Specific line or route to focus on | |
| time | No | Time of travel (e.g. 9am, rush hour) | |
| route | No | Line or route name (e.g. L train, Northern line) | |
| action | Yes | Which endpoint to call. Options: status | city | route | commute | airport | agencies | delays | delays-history | trip | multimodal | compare | carfree | visitor | coverage | |
| cities | No | Alternative: comma-separated pair (e.g. NYC,London) | |
| city_a | No | First city | |
| city_b | No | Second city | |
| airport | No | IATA code (JFK, LHR) or name | |
| flight_time | No | Flight departure time (e.g. 6am) | |
| neighborhood | No | neighborhood |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, placing full burden on the description. The description mentions pricing per endpoint and global coverage, but does not disclose behavioral traits like data freshness, rate limits, authentication needs, or side effects. For a data retrieval tool, read-only nature is implied but not stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is verbose and repetitive (e.g., 'TransitPulse: TransitPulse'). It includes a long list of endpoints with prices, which could be condensed or better organized. Not all content earns its place, making it less efficient for an agent to parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has many actions and no output schema, the description lacks critical information about which parameters are required for each action and what each endpoint returns. This makes it difficult for an agent to correctly select and invoke the tool without additional external knowledge.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so each parameter has a basic description. The tool's main description does not add further meaning or context to the parameters beyond what the schema already provides. Baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states it is a 'global public transit intelligence' tool covering route reliability, delay prediction, etc., which clearly communicates the domain. However, it does not differentiate from sibling tools beyond the domain name, which is sufficient given siblings cover different areas.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists multiple endpoints (actions) but provides no guidance on when to use each one or when to prefer this tool over siblings. Siblings are distinct by domain, so cross-tool guidance is not needed, but within the tool, no usage context is given for selecting among endpoints.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
travelpulseCInspect
TravelPulse: Global travel intelligence API. AI-synthesized destination guides, visa requirements, currency exchange, health advisories, packing lists, phrasebooks, weather, and travel insurance. Integrates real-t
Coverage: Global
Endpoints: • waits ($0.05): Live park wait times • hours ($0.05): Park hours and schedule • crowds ($0.08): Crowd prediction • weather ($0.05): Travel weather forecast • deals ($0.08): Travel deals • plan ($0.20): Trip itinerary • visa ($0.08): Visa requirements by nationality and destination • insurance ($0.08): Travel insurance comparison and recommendation • pack ($0.10): AI packing list by destination, climate, and activities • budget ($0.10): Daily travel budget by destination and style • currency ($0.08): Currency exchange rates and money tips for destination • phrasebook ($0.05): Essential travel phrasebook by destination language • translate ($0.03): Real-time travel translation (menus, signs, conversations) • health ($0.08): Destination health advisories and vaccine requirements
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Destination currency or country name | |
| date | No | YYYY-MM-DD, default today | |
| days | No | days | |
| from | No | Home currency (e.g. USD, EUR, GBP) — default: USD | |
| lang | No | lang | |
| park | No | Park name or slug e.g. magic-kingdom, universal-studios-florida, europa-park | |
| text | No | Text to translate | |
| focus | No | Phrase focus area (transport, food, emergency, shopping, all) | |
| style | No | style | |
| action | Yes | Which endpoint to call. Options: waits | hours | crowds | weather | deals | plan | visa | insurance | pack | budget | currency | phrasebook | translate | health | |
| amount | No | Amount to convert for reference calculation | |
| budget | No | budget | |
| context | No | Context hint (menu, sign, conversation, product) | |
| purpose | No | Visit purpose (tourism, business, nomad, transit) | |
| to_lang | No | Target language (default: English) | |
| bag_type | No | Luggage constraint | |
| duration | No | Trip duration in days | |
| from_lang | No | Source language (auto-detected if omitted) | |
| trip_type | No | Trip type — determines coverage priorities | |
| activities | No | Planned activities (e.g. hiking, beach, business, diving, winter sports) | |
| destination | No | destination | |
| nationality | No | Passport nationality (e.g. US, UK, India, Brazil, Nigeria) | |
| duration_days | No | Trip duration in days | |
| trip_cost_usd | No | Total prepaid trip cost in USD — for cancellation coverage sizing | |
| trip_duration | No | Trip duration (affects prophylaxis recommendations) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully disclose behavior. It mentions 'Integrates real-t' (incomplete) and lists endpoints with prices but omits key details like rate limits, data freshness, authentication requirements, or side effects. This lack of behavioral context limits transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is overly long and poorly structured. It begins with a general statement, then 'Coverage: Global', then a bullet list of endpoints with prices, and ends with a truncated sentence. This format wastes space and lacks a coherent flow, making it harder for an AI agent to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 25 parameters and no output schema or annotations, the description should thoroughly explain usage. It provides an endpoint list but fails to explain parameter combinations, return values, or how to construct requests for specific data (e.g., visa requirements need destination and nationality). The description is incomplete for such a complex tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage for all 25 parameters, so the schema already provides meaning. The description adds value by listing endpoint examples with prices (e.g., waits ($0.05)), which gives extra context for the 'action' parameter. However, it doesn't elaborate on other parameters beyond what the schema states, so it meets but does not exceed the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Global travel intelligence API' and lists endpoint categories like visa, weather, packing, etc. This clearly identifies the tool as a travel information provider. However, the description is fragmented with a truncated sentence and a list, which slightly detracts from clarity but still distinguishes it from sibling Pulse tools focused on other domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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. Sibling tools cover different topics, so the context is implied, but the description does not provide any when-to-use or when-not-to-use advice, nor does it specify scenarios where this tool is preferred over other travel tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
truthpulseCInspect
TruthPulse: Primary-source intelligence for FOIA releases, declassified archives, court records, forensic evidence, UAP disclosures, and conspiracy theory evidence briefs. Evidence-first. No spin. Global. All end
Coverage: Global
Endpoints: • foia-search ($0.10): FOIA release search • foia-draft ($0.15): FOIA request letter generator • court-case ($0.15): Court case intelligence • evidence-extract ($0.20): Forensic evidence extraction • declassified ($0.10): Declassified archive search • uap-records ($0.10): Global UAP/UFO government records • conspiracy-brief ($0.20): Conspiracy theory evidence brief • entity-network ($0.20): Entity connection mapping • new-releases ($0.08): Latest FOIA and court releases feed • media-vs-record ($0.20): Media narrative vs. court record • international-foia ($0.15): International FOI search and request drafting
| Name | Required | Description | Default |
|---|---|---|---|
| era | No | 1940s | 1950s | cold-war | 1970s | 1980s | post-911 | recent | all | |
| lang | No | en | es | fr | de | ja | pt | it | nl | ko | zh | ar | |
| depth | No | overview | deep-dive | |
| focus | No | all | charges | verdict | sentence | rulings | timeline | |
| limit | No | 5 | 10 | 20 | |
| topic | No | Topic to search — e.g. MKUltra, JFK assassination, Epstein, UFO, Operation Paperclip | |
| action | Yes | Which endpoint to call. Options: foia-search | foia-draft | court-case | evidence-extract | declassified | uap-records | conspiracy-brief | entity-network | new-releases | media-vs-record | international-foia | |
| agency | No | FBI | CIA | NSA | DEA | DOJ | DHS | all | |
| filter | No | Optional keyword filter — e.g. fentanyl | JFK | UAP | |
| source | No | cia | fbi | nsa | nara | uk | all | |
| country | No | US | UK | CA | AU | all | |
| include | No | individuals | organizations | cases | all | |
| subject | No | Person or organization — e.g. Jeffrey Epstein | Harvey Weinstein | HSBC | any subject | |
| category | No | foia | court | declassified | uap | all | |
| incident | No | Nimitz | Tic Tac | Roswell | AATIP | Gimbal | Rendlesham | Phoenix Lights | any — or leave blank for overview | |
| case_name | No | Defendant name, case name, or case number — e.g. Alex Murdaugh | State v. Myers | OJ Simpson | |
| fee_waiver | No | yes | no | |
| jurisdiction | No | US | UK | CA | AU | international | ICC | ECHR | auto | |
| case_or_topic | No | Case name, defendant, or topic — e.g. George Floyd | Karen Read | Uvalde response | Alex Murdaugh | |
| evidence_type | No | all | toxicology | autopsy | dna | financial | ballistics | digital | |
| include_draft | No | yes | no | |
| records_sought | No | Plain English description of the records you want | |
| requester_type | No | individual | journalist | researcher | nonprofit |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses the tool's multi-endpoint nature and costs per endpoint, but does not explain behavioral aspects such as rate limits, authentication requirements, error handling, or output format. The lack of behavioral depth is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the purpose but then lists all endpoints with costs, making it somewhat lengthy. It is organized with bullet points, but could be more concise by summarizing without line-item costs.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 23 parameters, no output schema, and no annotations, the description is incomplete. It does not explain return values, how to select between parameters that apply to different endpoints, or error handling. It provides a high-level overview but lacks depth for effective use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, with clear descriptions for each parameter. The description adds no additional meaning beyond listing endpoints with costs, which relates only to the 'action' parameter. Baseline 3 is appropriate as the schema already documents parameters adequately.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose as 'Primary-source intelligence for FOIA releases, declassified archives, court records, forensic evidence, UAP disclosures, and conspiracy theory evidence briefs.' It lists all endpoints, distinguishing it from sibling pulse tools which cover other domains. However, it could be more explicit that it is a dispatch tool for multiple sub-actions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description does not provide guidance on when to use this tool versus its siblings or compare it to alternatives. It lists endpoints but lacks context about which scenarios warrant using 'truthpulse' over other pulse tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
venturepulseCInspect
VenturePulse: Startup funding intelligence API. VC round data, investor matching, pitch deck scoring, term sheet decoding, cap table modeling, global accelerator directory, market sizing, legal formation, comparabl
Coverage: Global
Endpoints: • funding-search ($0.10): VC funding round intelligence • investor-match ($0.15): Investor matching engine • pitch-score ($0.20): Pitch deck scoring • term-sheet ($0.20): Term sheet decoder • cap-table ($0.15): Cap table dilution modeler • accelerator ($0.10): Global accelerator directory • market-size ($0.15): TAM/SAM/SOM market size analysis • legal-formation ($0.15): Startup legal formation guide • comparable ($0.10): Comparable deal benchmarks • due-diligence ($0.15): Investor due diligence prep
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | en | es | fr | de | ja | pt | it | nl | ko | zh | ar | |
| focus | No | legal | financial | technical | all | |
| stage | No | pre-seed | seed | series-a | series-b | growth | any | |
| terms | No | Paste the full term sheet text or describe specific clauses to decode | |
| action | Yes | Which endpoint to call. Options: funding-search | investor-match | pitch-score | term-sheet | cap-table | accelerator | market-size | legal-formation | comparable | due-diligence | |
| region | No | us | eu | uk | apac | latam | mena | africa | global | |
| sector | No | fintech | saas | biotech | ai | climate | consumer | b2b | deeptech | any | |
| country | No | US | UK | CA | AU | SG | IE | DE | FR | IN | BR | NL | SE | IL | NZ | JP | KR | |
| is_safe | No | true | false — whether this is a SAFE note | |
| approach | No | top-down | bottom-up | both | |
| geography | No | global | us | eu | uk | apac | latam | mena | africa | specific country | |
| raise_usd | No | Amount being raised in USD — e.g. 2000000 | |
| structure | No | priced | safe | note | |
| check_size | No | Target check size in USD — e.g. 500000 | |
| equity_max | No | Maximum equity percentage willing to give up — e.g. 7 | |
| description | No | Plain English description of your startup — what it does, for whom, how it makes money | |
| founders_pct | No | Current founder ownership percentage — e.g. 80 | |
| pre_money_usd | No | Pre-money valuation in USD — e.g. 8000000 | |
| target_markets | No | Where you plan to sell — e.g. US, EU | |
| option_pool_pct | No | Current option pool percentage | |
| founder_locations | No | Where founders are located — e.g. US, Germany (default: same as country) | |
| existing_investors_pct | No | Existing investor ownership percentage | |
| option_pool_increase_pct | No | New option pool percentage required by investors |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions 'Coverage: Global' but fails to disclose important behavioral traits such as whether calls are read-only, potential destructive actions, authentication requirements, rate limits, or pricing implications (prices are listed but not explicitly stated as costs per call). For a tool that routes to many backend APIs, critical behavioral context is missing.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is overly verbose, including pricing in parentheses and a full list of endpoints with prices. It is not front-loaded with the essential purpose; the key information ('Startup funding intelligence') appears first, but the rest is cluttered. The structure could be more concise and focused on the tool's functionality.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (23 parameters, 10 actions, no output schema, no annotations), the description is incomplete. It does not explain routing logic, parameter-action dependencies, expected response structure, error handling, or how to choose between endpoints. The tool's multi-endpoint nature demands more thorough documentation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description lists endpoints but does not clarify which parameters apply to which action. For example, the 'terms' parameter likely applies only to the 'term-sheet' action, but this is not stated. The description adds minimal semantic value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Startup funding intelligence API' and lists ten specific endpoints, clearly indicating it provides startup funding data and analysis. This distinguishes it from sibling Pulse tools that focus on other domains (e.g., climatepulse, patentpulse). However, the purpose is diffuse due to the many endpoints and the inclusion of pricing details, which dilute the core message.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description does not provide any guidance on when to use this tool versus the numerous sibling tools. There is no explicit statement of when not to use it or which scenarios are better suited for other tools. The agent is left to infer from the tool name and endpoint list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
vetpulseAInspect
VetPulse: US veterans benefits intelligence API. AI-synthesized guidance on VA disability compensation, Aid & Attendance pension, TDIU, claim strategy, caregiver stipends, GI Bill, state benefits, VA healthcare
Coverage: Global
Endpoints: • disability ($0.15): VA disability rating analysis • aid-attendance ($0.15): VA Aid & Attendance pension eligibility • tdiu ($0.15): TDIU (Total Disability Individual Unemployability) eligibility • claim-builder ($0.20): VA disability claim evidence strategy • caregiver ($0.10): PCAFC caregiver stipend and benefits • education ($0.10): GI Bill and education benefit comparison • state-benefits ($0.10): State-specific veteran benefits (all 50 states) • home-loan ($0.08): VA home loan benefit analysis • discounts ($0.05): Verified veteran discounts by category • healthcare ($0.08): VA healthcare priority group and coverage analysis
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Veteran age | |
| lang | No | Response language — any language supported | |
| needs | No | Care needs description (e.g. 'requires daily assistance with bathing, dressing, and medication management') | |
| state | No | US state name or abbreviation (e.g. 'Texas', 'TX') | |
| action | Yes | Which endpoint to call. Options: disability | aid-attendance | tdiu | claim-builder | caregiver | education | state-benefits | home-loan | discounts | healthcare | |
| assets | No | Total net worth in USD excluding primary home and one vehicle | |
| branch | No | Military branch — affects reserve component benefit calculations | |
| income | No | Monthly gross income in USD (Social Security, pension, other) | |
| rating | No | Current combined disability rating (e.g. '70' or '60') | |
| chapter | No | GI Bill chapter of interest (e.g. '33', '30', '35', '1606') — or omit for full comparison | |
| category | No | Discount category. Defaults to all. | |
| care_cost | No | Monthly unreimbursed care costs in USD — deducted from income for pension calculation | |
| conditions | No | Comma-separated medical conditions (e.g. 'tinnitus,PTSD,lumbar strain,sleep apnea') | |
| dependents | No | Whether veteran has dependents — affects DEA transferability and some benefit calculations | |
| service_era | No | Service era for presumptive condition assessment (e.g. 'Vietnam', 'Gulf War', 'OEF', 'OIF', 'Korea') | |
| relationship | No | Caregiver relationship to veteran (e.g. 'spouse', 'adult child', 'parent', 'sibling') | |
| work_history | No | Work history and current work status (e.g. 'cannot maintain substantially gainful employment due to PTSD and chronic pain') | |
| prior_va_loan | No | Whether veteran has used a VA loan before — triggers entitlement restoration guidance | |
| veteran_needs | No | Description of veteran's care needs (e.g. 'severe TBI requires 24hr supervision, cannot be left alone') | |
| current_rating | No | Current combined rating if filing a supplemental or new claim | |
| discharge_date | No | Approximate discharge date — PCAFC eligibility expanded in 2020 to all service eras | |
| priority_group | No | Current VA priority group if known (1–8) | |
| purchase_price | No | Target home purchase price in USD — used to calculate funding fee savings and PMI comparison | |
| school_location | No | School city and state — used to estimate monthly housing allowance (E-5 with dependent BAH rate) | |
| previous_denials | No | Description of any previous claim denials — affects strategy (HLR vs. Board appeal vs. supplemental) | |
| surviving_spouse | No | Set true if applicant is a surviving spouse of a veteran — unlocks Survivors Pension and different Aid & Attendance rates | |
| disability_rating | No | VA disability rating percentage — many state benefits require minimum rating (e.g. '70', '100', 'P&T') |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It reveals that the tool provides 'AI-synthesized guidance' (not official VA info) and lists costs per endpoint. However, it does not cover rate limits, authentication needs, error behavior, or what happens to provided data (no destructive hints).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a lead sentence, a 'Coverage' line, and a bullet list of endpoints. It is relatively long but front-loaded with purpose. The 'Coverage: Global' line adds little value for a US-focused tool, and the pricing info could be in annotations.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (27 params, many endpoints), the description provides a good high-level overview. However, it lacks usage guidance, output description, and parameter-endpoint mappings. Without an output schema, the description does not explain what the tool returns (e.g., a text response, structured data).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 27 parameters thoroughly. The description adds value by grouping endpoints and stating their purpose, but it does not clarify which parameters apply to which endpoint or provide usage examples beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool as 'US veterans benefits intelligence API' and lists specific endpoints (disability, aid-attendance, etc.), making its purpose unmistakable. The sibling tools have different domains (e.g., alphapulse for alpha, biopulse for biology), so vetpulse is well differentiated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description lists endpoints and their costs, which implies when to use each, but it does not explicitly state when to choose vetpulse over sibling tools or when not to use it. There is no guidance on prerequisites, fallback options, or exclusion criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
waterpulseBInspect
WaterPulse: Global water intelligence API. 9 endpoints covering US groundwater (USGS), streamflow, drought (US Drought Monitor), water quality (EPA WQP), aquifer sustainability, flood risk, global water stress, a
Coverage: Global
Endpoints: • groundwater ($0.08): Groundwater levels (USGS) • streamflow ($0.05): Streamflow — river discharge (USGS) • drought ($0.08): Drought status (US Drought Monitor) • quality ($0.08): Water quality (EPA WQP + USGS) • aquifer ($0.15): Aquifer sustainability analysis • flood-risk ($0.15): Flood risk intelligence • global-stress ($0.15): Global water stress by country/basin • agriculture-use ($0.15): Agricultural water use intelligence • supply-brief ($0.50): Municipal water supply brief
| Name | Required | Description | Default |
|---|---|---|---|
| crop | No | Crop type — e.g. alfalfa, cotton, corn, almonds, rice | |
| lang | No | lang | |
| site | No | USGS site number — e.g. 09380000 (Colorado River at Lees Ferry) | |
| focus | No | agriculture | municipal | industrial | conflict | investment | all | |
| limit | No | Number of monitoring sites (5, 10, or 20) | |
| state | No | Two-letter US state code — e.g. CA, TX, AZ, FL, KS | |
| action | Yes | Which endpoint to call. Options: groundwater | streamflow | drought | quality | aquifer | flood-risk | global-stress | agriculture-use | supply-brief | |
| region | No | Country, region, or river basin — e.g. India, Middle East, Nile Basin, Murray-Darling | |
| aquifer | No | Aquifer name — e.g. Ogallala, Central Valley, Floridan, Edwards, High Plains | |
| location | No | City, county, or river — e.g. Nashville TN, Mississippi River Iowa | |
| parameter | No | nitrates | phosphorus | ph | lead | arsenic | bacteria | pfas | turbidity |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description does not disclose behavioral traits such as rate limits, authentication requirements, data freshness, or side effects. The brief endpoint descriptions do not go beyond stating the data source.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is reasonably concise but structurally messy, mixing a title line, coverage line, and endpoint list with costs. It could be better organized.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 9 endpoints and no output schema, the description should explain what each endpoint returns, but it only provides very brief one-liners (e.g., 'Groundwater levels (USGS)'). This is insufficient for complete understanding.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema fully documents all parameters. The description adds no additional meaning beyond what is in the schema, 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.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it is a 'Global water intelligence API' and lists all 9 endpoints with their specific data domains (groundwater, streamflow, drought, etc.), making it distinct from sibling tools which are for other domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for water-related data queries by listing endpoints, and the sibling tools are domain-specific, so context is clear. However, there is no explicit guidance on when not to use this tool or alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
wealthpulseCInspect
WealthPulse: Personal finance intelligence API. 12 endpoints grounded in live FRED rate data — financial health, retirement, debt, credit cards, mortgage, Social Security, tax optimization, Roth vs Traditional, em
Coverage: Global
Endpoints: • snapshot ($0.15): Financial health snapshot • retire ($0.15): Retirement readiness projection • debt ($0.10): Debt payoff strategy • cards ($0.10): Credit card optimization • mortgage ($0.10): Mortgage affordability analysis • debt-negotiate ($0.15): DIY debt negotiation protocol • advisor ($0.10): Financial advisor intelligence • ssa ($0.15): Social Security claiming strategy • tax ($0.15): Year-end tax optimization • roth ($0.10): Roth vs Traditional IRA/401k decision • emergency ($0.10): Emergency fund sizing • inheritance ($0.10): Inherited IRA and estate rules
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | age | |
| debt | No | debt | |
| down | No | down | |
| firm | No | For action=vet | |
| lang | No | lang | |
| name | No | Required for action=vet | |
| type | No | credit_card | medical | personal | auto | student | |
| debts | No | name:balance:rate format, comma-separated (e.g. credit-card:8500:24,car-loan:12000:6.5) | |
| extra | No | extra | |
| state | No | state | |
| action | No | action | |
| health | No | health | |
| income | No | Annual income in USD | |
| balance | No | balance | |
| monthly | No | monthly | |
| savings | No | savings | |
| advisors | No | Required for action=compare | |
| creditor | No | creditor | |
| expenses | No | Monthly expenses in USD | |
| job_type | No | job_type | |
| location | No | location | |
| your_age | No | your_age | |
| retire_at | No | retire_at | |
| situation | No | situation | |
| specialty | No | Required for action=find | |
| birth_year | No | Year of birth (used to calculate Full Retirement Age) | |
| dependents | No | dependents | |
| account_type | No | account_type | |
| credit_score | No | credit_score | |
| current_fund | No | Existing emergency fund in USD | |
| relationship | No | relationship | |
| filing_status | No | filing_status | |
| spend_profile | No | spend_profile | |
| target_income | No | target_income | |
| employer_match | No | employer_match | |
| marital_status | No | marital_status | |
| original_owner_age | No | Original owner's age at time of death |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full responsibility for behavioral disclosure. It mentions that data is 'grounded in live FRED rate data' but lacks details on rate limits, cost per request (prices are listed but not tied to API usage), data persistence, or side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is long and includes a bullet list of endpoints, which is moderately structured. However, it could be more concise by focusing on the tool's overall behavior and reducing redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 37 parameters, no output schema, and no annotations, the description is insufficient. It fails to explain how parameters relate to the action parameter or what the return values look like, leaving agents under-informed for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is 100%, all parameter descriptions are tautological (e.g., 'age: age'). The description does not elaborate on parameter usage or valid values, and the 'action' parameter lacks enumeration, leaving agents uncertain about valid actions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Personal finance intelligence API' and lists 12 endpoints with prices. However, it does not clearly define the single purpose of the tool; instead it presents multiple distinct functions. This creates ambiguity about when to use wealthpulse versus sibling tools like debtpulse or taxpulse.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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. The description lists many endpoints but does not explain how to select the appropriate action parameter or when not to use the tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
Most tools have clearly distinct domains (e.g., alphapulse vs. arbipulse), but occasional overlap exists (e.g., debtpulse/wealthpulse, careerpulse/talentpulse) that could cause confusion.
All tools follow a consistent '[domain]pulse' pattern, and endpoints within each use lowercase with hyphens or concatenated words, maintaining uniformity throughout.
With 69 tools, the count far exceeds the typical 3-15 well-scoped range, likely overwhelming agents and making selection difficult.
Each domain-specific tool covers key endpoints for its area, but a few potential gaps exist (e.g., missing integration across tools). Overall, the surface is broad and largely complete for the stated verticals.
Maintenance
Related MCP Connectors
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
8 pay-per-call web intel tools over MCP. Free discovery, calls settle in USDC on Base (x402).
Related MCP Servers
- AlicenseAqualityDmaintenance22 MCP tools for AI agents: crypto prices and trading signals (53 coins), stock prices and company financials, forex rates and conversion, and web scraping with AI summaries. All powered by x402 USDC micropayments on Base. $0.01-$0.25 per request.2219MIT
- AlicenseNot gradedqualityCmaintenance250+ AI-powered MCP tools: research, write, code, translate, scrape, sentiment, vision, RAG, agent memory, marketplace, trading signals, and more. 15 models across 7 providers. Pay-per-use via API key or x402 USDC micropayments.2MIT
- AlicenseNot gradedqualityAmaintenance62 real-time data tools for AI agents via MCP. Finance, crypto, FMCSA, sanctions, courts, weather, vehicles, cybersecurity. One bearer token, one bill. Free tier available.MIT
- AlicenseNot gradedqualityBmaintenance55+ pay-per-call tools for AI agents over MCP: live telemetry, blockchain/on-chain checks, environmental, transit, finance, and network utilities. No API key or signup — agents pay per request with x402 USDC micropayments (Base and Solana).MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/GTCC777/mcp-pulsenetwork'
If you have feedback or need assistance with the MCP directory API, please join our Discord server