Skip to main content
Glama

Server Details

Free, public, read-only REST + Model Context Protocol server exposing real-time and historical DeFi liquidation telemetry for Aave, Morpho, Spark and Compound on Ethereum mainnet, plus block-builder market share data from the operator's own slot-by-slot shadow recorder.

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL

Glama MCP Gateway

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

MCP client
Glama
MCP server

Full call logging

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

Tool access control

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

Managed credentials

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

Usage analytics

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

100% free. Your data is private.
Tool DescriptionsA

Average 4.1/5 across 17 of 18 tools scored. Lowest: 3.2/5.

Server CoherenceA
Disambiguation5/5

Each tool has a clearly distinct purpose, from borrower queries to private watch management and builder stats. Even similar tools like list_borrowers and list_at_risk_borrowers are differentiated by parameters and use cases.

Naming Consistency5/5

All tools follow a consistent snake_case pattern with the 'seneschal_' prefix and verb_noun structure (get_borrower, list_borrowers, create_watch, etc.). No mixing of conventions.

Tool Count5/5

With 18 tools covering borrower monitoring, flash loans, builder stats, premium data, private watch services, and utility endpoints, the count is well-scoped for the server's broad purpose without being excessive.

Completeness4/5

The tool set covers core CRUD operations for borrowers, private watch create/topup, and various queries. Minor gaps exist (e.g., no delete or manage watch tool, no update for watches), but overall the surface is comprehensive for the advertised domains.

Available Tools

19 tools
seneschal_builder_leaderboardBuilder leaderboardAInspect

Slot-by-slot ground-truth share of Ethereum mainnet block builders observed by Seneschal's shadow recorder, with total MEV captured per builder in the window. Cached for 60s.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoTop-N builders to return. Default 20.
windowNoLookback window. Default 24h.
Behavior3/5

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 caching for 60s but does not mention read-only nature, rate limits, or any side effects. Adequate but could be improved.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences effectively convey purpose, data content, and caching behavior without waste. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given two parameters and no output schema, the description covers the key aspects: data source (Seneschal shadow recorder), content (builder share and MEV), and caching. It could detail the return shape slightly more, but is largely complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, with both parameters described (limit and window). The description adds minimal extra meaning beyond 'Top-N builders' and does not elaborate on parameter behavior.

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

Purpose5/5

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

The description clearly states that the tool returns slot-by-slot ground-truth share of Ethereum block builders and total MEV captured per builder, distinguishing it from sibling tools that deal with flashloans, borrowers, and liquidations.

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

Usage Guidelines3/5

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

The description does not explicitly state when to use this tool versus alternatives, though the sibling tools cover different topics, so confusion is unlikely. Guidance on usage context is implicit.

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

seneschal_flashloan_providersFlash loan provider catalogueAInspect

Curated catalogue of Ethereum mainnet flash-loan providers (Aave V3, Balancer V2, Morpho Blue, Uniswap V3, FlashBank) with current fee in basis points, contract addresses, qualitative liquidity notes, and per-provider caveats. Helpful for searcher agents picking the cheapest viable provider for a liquidation or arbitrage strategy. The catalogue is editorially open: filter by chain, max fee, or multi-asset support.

ParametersJSON Schema
NameRequiredDescriptionDefault
chainNoChain key, default "ethereum". Currently only ethereum is catalogued.
max_fee_bpsNoDrop providers whose flat fee exceeds this in basis points (1 bp = 0.01%).
multi_assetNoIf true, only return providers that support borrowing multiple assets in a single flash loan.
Behavior3/5

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 implies a read-only query operation ('curated catalogue'), but does not explicitly state whether modifications occur or if there are side effects. The qualitative liquidity notes suggest safe data retrieval.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences long with no redundancy. Every part adds value: purpose, contents, use case, and filter options. Front-loaded with key information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description explains the return values (fee, addresses, liquidity notes, caveats) despite no output schema. Parameter semantics are covered by schema. The tool is a simple query with no nested objects, so the provided context is sufficient for an agent to decide to invoke it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, the schema already documents all three parameters (chain, max_fee_bps, multi_asset). The description reiterates filtering but adds no new meaning beyond what the schema provides, warranting a baseline score of 3.

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

Purpose5/5

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

The description clearly identifies the tool as a curated catalogue of Ethereum mainnet flash-loan providers, listing specific providers and details. It distinguishes from sibling tools (e.g., borrower lists, liquidations) by focusing exclusively on provider information.

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

Usage Guidelines4/5

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

The description states it is 'helpful for searcher agents picking the cheapest viable provider' and mentions filter options, establishing clear usage context. It could be improved by explicitly stating when not to use it, but the purpose is well understood from the sibling set.

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

seneschal_get_borrowerGet borrower snapshotAInspect

Returns the latest known state of address across every protocol where we have data (Aave, Morpho, Spark). Pass the EOA / contract address as a 0x-prefixed 20-byte hex string.

ParametersJSON Schema
NameRequiredDescriptionDefault
addressYes
Behavior3/5

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

No annotations are provided, so the description must convey behavior. It explains the data scope and input format but lacks details on data freshness, error handling, or authentication requirements.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences, no fluff, and the most important information (purpose and parameter format) is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description does not explain the return structure (e.g., fields in the snapshot). For a retrieval tool, this is a gap, though the core concept is clear.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema coverage, the description adds meaning by specifying the address format (0x-prefixed 20-byte hex) and clarifying it returns state across protocols. This goes beyond the schema pattern.

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

Purpose5/5

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

The description clearly states the tool returns the latest known state of an address across multiple protocols (Aave, Morpho, Spark), distinguishing it from siblings like seneschal_get_borrower_history and seneschal_list_borrowers.

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

Usage Guidelines3/5

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

Usage context is implied but not explicit. It does not specify when to use this tool versus alternatives (e.g., for history use the sibling tool) or any exclusions.

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

seneschal_get_borrower_historyGet borrower historyAInspect

Returns a time series of (timestamp, health_factor, collateral_usd, debt_usd) observations for address on protocol. Granularity defaults to raw observations; use hour or day for chart-friendly buckets.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax rows fetched from history table before bucketing.
addressYes
protocolYesOnly aave and morpho have history tables.
since_msNoUnix epoch ms. Defaults to now − 7d.
until_msNoUnix epoch ms. Defaults to now.
granularityNoBucket size; default raw.
Behavior3/5

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 explains the return shape and granularity but does not disclose behavioral traits like data ordering, pagination, or potential side effects. It implies read-only behavior but could be more transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences convey the core purpose and an important usage tip with no redundancy. The key action ('Returns a time series...') is front-loaded, making it easy for an agent to quickly grasp.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 6 parameters (2 required) and no output schema, the description successfully covers the returned fields and the most important parameter (granularity). Defaults and other parameters are adequately handled by the schema. Minor omissions like ordering or data limits are acceptable given the tool's straightforward nature.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 83%, meeting the high-coverage baseline of 3. The description adds value by explaining granularity options and their intent ('chart-friendly buckets') and clarifies limit as 'Max rows fetched before bucketing'. This goes beyond the schema's basic descriptions.

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

Purpose5/5

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

Clearly states it returns a time series of specific fields (timestamp, health_factor, collateral_usd, debt_usd) for a given address and protocol. This distinguishes it from sibling tools like seneschal_get_borrower (likely current state) or seneschal_list_borrowers (list view).

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

Usage Guidelines4/5

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

Provides guidance on granularity options ('use hour or day for chart-friendly buckets') but does not explicitly compare to sibling tools or state when not to use it. Implicitly suggests it's for historical data but lacks explicit alternatives or exclusions.

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

seneschal_healthService healthAInspect

Returns table sizes and data-source freshness timestamps for the Seneschal Data backend.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Behavior3/5

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

No annotations provided; description indicates a read operation returning data but does not mention side effects, caching, or authentication requirements. Adequate but minimal disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence, 13 words, front-loaded with verb and resource. No unnecessary information; earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no parameters and no output schema, the description adequately informs what data is returned. Could mention output format but not critical for a simple health tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters in schema (100% coverage). Description adds meaning by specifying what the tool returns (table sizes and freshness timestamps), which is sufficient for a parameterless tool.

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

Purpose5/5

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

Description clearly states verb 'Returns' and specific resources 'table sizes and data-source freshness timestamps' for the Seneschal Data backend, effectively distinguishing it from sibling tools that focus on borrowers, liquidations, etc.

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

Usage Guidelines3/5

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

The description implies usage for monitoring backend health but provides no explicit when-to-use or alternatives. Lacks 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.

seneschal_list_at_risk_borrowersList at-risk borrowersBInspect

Current snapshot of borrowers across Aave, Morpho, and Spark whose health factor sits below max_hf, sorted ascending. Use min_debt_usd to ignore dust positions.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax rows. Default 50, max 500.
max_hfNoReturn only borrowers with health factor strictly less than this. Default: no cap.
protocolNoRestrict to one protocol; omit for all.
min_debt_usdNoIgnore positions with debt smaller than this many USD. Default: 0.
Behavior3/5

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

With no annotations, the description must cover behavioral traits. It states it's a 'current snapshot' (point-in-time) and 'sorted ascending', but does not disclose pagination, authentication requirements, or response structure. 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.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences front-loading the main purpose. No extraneous words. Exemplary succinctness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite clear purpose, the description lacks details about the output format (e.g., what fields are returned). Without an output schema, the agent has to guess the response structure, which is a significant gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% so parameters are already documented. The description adds context for max_hf and min_debt_usd but not for limit or protocol. Baseline 3 is appropriate as 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.

Purpose4/5

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

The description clearly states the tool lists at-risk borrowers with health factor below max_hf, sorted ascending, and mentions three protocols. However, it omits 'compound' from the enumeration even though the schema includes it, causing a minor inconsistency.

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

Usage Guidelines2/5

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

No explicit guidance on when to use this tool versus siblings like 'seneschal_list_borrowers'. The description does not mention alternatives or when not to use it, leaving the agent to infer from the name alone.

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

seneschal_list_borrowersList borrowers (generic)AInspect

Generic discovery surface over the borrower snapshot table. Like seneschal_list_at_risk_borrowers but with both lower and upper HF bounds, optional max-debt cap, configurable sort field/direction, and offset-based pagination. Use this to walk the catalogue without knowing borrower addresses in advance.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax rows per page. Default 50, max 500.
max_hfNoExclusive upper bound on health factor.
min_hfNoInclusive lower bound on health factor.
offsetNoPagination offset. Default 0.
sort_byNoDefault 'health_factor'.
protocolNoRestrict to one protocol; omit for all.
sort_dirNoDefault 'asc'.
max_debt_usdNoMaximum debt in USD (default unbounded).
min_debt_usdNoMinimum debt in USD (default 0).
Behavior3/5

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

No annotations are provided, so the description must fully disclose behavioral traits. It mentions the tool operates on a 'snapshot table' and supports pagination, but does not specify whether it is read-only, idempotent, or if it has side effects. The description partially fulfills the transparency burden by explaining the filtering and sorting behavior, but lacks explicit safety characteristics.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description consists of two dense sentences. The first sentence establishes the purpose and the second adds critical details and usage guidance. Every word serves a purpose; there is no repetition or filler. It is front-loaded and highly efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (9 parameters, no output schema), the description adequately explains the tool's scope, filtering capabilities, and pagination. It does not describe the response format, but the tool is a list operation and the schema fully documents parameters. The description could be more complete by noting the default limit and max, but those are in the schema. Overall, it provides sufficient context for an 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.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, giving a baseline of 3. The description adds value beyond the schema by explaining the purpose of the extra parameters relative to the sibling (lower/upper HF bounds, max-debt cap, sort field/direction, offset pagination). This contextualizes the parameters and clarifies their role in the tool's functionality.

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

Purpose5/5

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

The description clearly states it is a 'generic discovery surface' over the borrower snapshot table, distinguishes it from the sibling `seneschal_list_at_risk_borrowers` by listing additional capabilities (lower/upper HF bounds, max-debt cap, configurable sort, offset pagination), and uses specific verbs like 'walk the catalogue'. The purpose is immediately clear and distinct.

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

Usage Guidelines4/5

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

The description says 'Use this to walk the catalogue without knowing borrower addresses in advance.', providing a clear use case. It contrasts with the sibling tool by noting differences in HF bounds and pagination, but does not explicitly state when not to use it or when to prefer alternatives. However, the guidance is sufficient for typical selection decisions.

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

seneschal_paywall_infoPaywall / x402 metadataAInspect

Returns the protocol, network, recipient address, and per-call price for every gated endpoint on this data backend. Free to call. Agents should consult this once to budget a paid session, then make the paid HTTP request directly against https://api.seneschal.space/v1/premium/opportunities with an x402 PAYMENT-SIGNATURE header (see https://docs.x402.org).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Behavior4/5

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

Since no annotations are provided, the description carries the full burden. It states 'Free to call,' implying no destructive side effects. It does not mention idempotency or caching, but for a metadata endpoint this is sufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences: the first states what it returns, the second provides usage guidance. No wasted words, front-loaded with essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description fully explains what the tool returns (list of paywall metadata fields). It also tells the agent what to do next, making it complete for its simple purpose.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0 parameters, so schema coverage is 100%. The description adds context about what is returned but no parameter information is needed. Score reflects the baseline for 0-param tools.

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

Purpose5/5

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

The description clearly states it returns protocol, network, recipient address, and per-call price for every gated endpoint. This distinguishes it from sibling tools that provide specific data like borrower lists or leaderboards.

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

Usage Guidelines5/5

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

Explicitly says it is free to call, agents should consult once to budget a paid session, then make the direct HTTP request with a payment signature. This provides clear when-to-use and what to do after.

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

seneschal_premium_builder_statsPremium per-builder bid distribution (paid)AInspect

Per-builder bid distribution (p25/median/p75/p90/p99/max ETH) and a 24-element hourly slot histogram over a configurable window. Sourced from the Seneschal shadow recorder so it covers every observed slot, not just landed blocks. Behind an x402 paywall at the REST surface; this MCP tool serves the data directly to authenticated agents.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax builders returned (1..100). Defaults to 25.
window_msNoLookback window in milliseconds. Defaults to 7 days. Clamped to [1h, 30d].
Behavior4/5

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

No annotations, but description adds key behavioral context: data comes from shadow recorder covering all observed slots (not just landed blocks) and requires authentication via MCP. Would benefit from stating read-only nature or any 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.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, each adding distinct value: output specification, data provenance, and access method. No redundancy or fluff. Front-loaded with essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers core output shape, source, and access. Lacks explicit mention of return format or units (though ETH is inferable from 'ETH'). With no output schema, slightly more detail on response structure would improve completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema descriptions already cover both parameters (limit and window_ms) with defaults and constraints. Description adds no extra parameter details beyond 'configurable window', so baseline 3 is appropriate.

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

Purpose5/5

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

Description clearly states it returns per-builder bid distribution (percentiles) and hourly slot histogram. Distinguishes from siblings by specifying 'premium' and mentioning the shadow recorder source, which is unique among the listed sibling tools.

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

Usage Guidelines3/5

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

Description implies use for premium bid data from shadow recorder, but does not explicitly compare with siblings or state when not to use it. Agents must infer from context; no direct guidance on alternatives.

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

seneschal_premium_opportunitiesPremium opportunity feed (paid)AInspect

Top at-risk borrowers across Aave + Morpho + Spark, annotated with realised 7d market intel (top liquidators, win rate, our own attempt outcomes) and ranked by expected liquidation value. Behind an x402 paywall: free agents see a paywall stub describing how to pay; paying agents fetch the full feed at https://api.seneschal.space/v1/premium/opportunities. Use seneschal_paywall_info to inspect the price/network/recipient before opening a session.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum opportunities returned (1..500). Defaults to 200.
since_msNoLookback window start (epoch ms). Defaults to now − 7d.
min_debt_usdNoMinimum debt-USD to include. Defaults to 0.
liquidation_bonusNoOverride the assumed liquidation bonus (e.g. 0.05 for 5%). Defaults to 0.06.
Behavior3/5

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

With no annotations, the description carries full burden. It discloses the paywall and differences between free and paying access, but does not detail the output format, rate limits, or specific authentication steps beyond the paywall.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three sentences long, front-loads the tool's purpose, then explains the paywall mechanism, and ends with a usage tip. No redundant information, highly efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers purpose and paywall, but does not specify the output structure or fields. With no output schema, more detail on the returned data would improve completeness. The context is adequate but not thorough.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with all parameters described in the input schema. The description adds no extra parameter-level context beyond what's already in the schema, so the baseline score of 3 applies.

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

Purpose5/5

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

The description clearly states it returns top at-risk borrowers across Aave, Morpho, and Spark, annotated with market intel and ranked by expected liquidation value. This specific verb and resource, combined with the paywall distinction, differentiates it from siblings like seneschal_list_at_risk_borrowers.

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

Usage Guidelines4/5

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

The description explicitly advises using seneschal_paywall_info to inspect pricing before use, providing clear prerequisite guidance. It also explains the paywall behavior for free vs paying agents, though it lacks explicit when-not-to-use guidance.

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

seneschal_private_watch_createCreate a Monero/Zcash payment watch (paid via x402 at REST)AInspect

Subscribe a Monero or Zcash address to view-key-based payment monitoring. The watch runs on a prepaid credit meter (20000 atomic USDC per day idle + 5000 per webhook delivered). Creation at the REST surface (POST /v1/private/watch) is paywalled at $0.10 via x402 and seeds the watch with $0.10 of credit. Receiver gets HMAC-signed webhooks plus a 'credit' block on every body; a 'low_credit' warning fires once before the meter expires. Top up via /v1/private/topup, topup-1, or topup-5. View keys are AES-256-GCM encrypted at rest.

ParametersJSON Schema
NameRequiredDescriptionDefault
chainYesWhich privacy chain to monitor.
addressYesPublic address for the chain. Monero: standard 95-char base58. Zcash: u1*, t1*, t3*, zs1*.
viewKeyYesMonero: 64-hex private view key. Zcash: UFVK starting with uview1.
webhookUrlYesHTTPS endpoint we POST signed webhooks to. Private RFC1918/localhost addresses are rejected.
birthdayHeightNoBlock height the wallet was created at. Monero: scans forward from this height. Zcash: defaults to NU6 (3_042_000) if unspecified.
Behavior4/5

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

No annotations provided, so the description carries the full burden. It discloses important behavioral traits: prepaid credit meter, HMAC-signed webhooks, low_credit warning, and encryption of view keys. It does not mention rate limits or auth requirements beyond the paywall, but overall is fairly transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single paragraph that packs substantial information without being overly verbose. It could be structured into bullet points for clarity, but it is efficient and front-loaded with the key purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is complex (paywall, credit meter, encryption), and the description covers many aspects. However, it lacks explicit detail on the return value of the create call (e.g., what the immediate response is, whether it returns a watch ID). The webhook behavior is described, but the synchronous response is not clarified.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, but the description adds significant value beyond the schema: address formats for Monero and Zcash, view key formats, webhook URL restrictions, and birthday height defaults. This goes beyond the schema's minimal descriptions.

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

Purpose4/5

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

The description clearly states the verb ('subscribe') and resource ('Monero or Zcash address to view-key-based payment monitoring'), distinguishing the tool's core function. However, it does not explicitly differentiate from sibling tools like seneschal_private_watch_info or seneschal_private_watch_topup, so a slight deduction.

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

Usage Guidelines3/5

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

The description provides context about payment (x402 paywall, credit meter) and topup alternatives, but lacks explicit guidance on when to use this tool vs. alternatives (e.g., when not to use it). The information is present but not structured as usage guidelines.

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

seneschal_private_watch_derive_viewkeyDerive a Zcash UFVK from a BIP-39 mnemonic (FREE, rate-limited)AInspect

Hands a 12- or 24-word seed phrase to NFPT's orchard-scanner CLI, returns the matching UFVK. FREE but rate-limited to 6/minute/IP. Be loud about the security trade-off: the phrase transits our server (no logging, no persistence) but a network observer between you and us would see the bytes. Offline derivation with the orchard-scanner binary on a trusted host is the safer alternative — see https://docs.seneschal.space/derive-locally. A UFVK is read-only; it cannot spend funds.

ParametersJSON Schema
NameRequiredDescriptionDefault
chainYesCurrently only Zcash (Orchard) UFVK derivation is supported; Monero coming later.
phraseYes12- or 24-word BIP-39 mnemonic.
networkNoZcash network the wallet belongs to.mainnet
Behavior4/5

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

Discloses that the mnemonic transits the server (no logging/persistence) and that network observers could see bytes, plus notes UFVK is read-only. However, does not mention any authentication requirements or error handling behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, front-loaded with action, no unnecessary words, and effectively combines purpose, warnings, and alternatives.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers purpose, usage, security, and behavior. Lacks explicit mention of output format or what happens on invalid input, but is sufficient given no output schema and simple return value.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, and the description adds security context for the 'phrase' parameter and future support for Monero, enhancing understanding beyond raw schema descriptions.

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

Purpose5/5

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

The description clearly states it derives a UFVK from a BIP-39 mnemonic using a specific CLI, distinguishing it from sibling tools that focus on watching or top-ups.

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

Usage Guidelines5/5

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

Explicitly mentions free usage, rate limit (6/minute/IP), security trade-offs, and recommends offline derivation as a safer alternative, providing clear when-to-use and when-not-to-use guidance.

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

seneschal_private_watch_historicalOne-off historical scan (paid via x402 at REST)AInspect

Return all spendable + spent notes for a view key without setting up a watch. The view key never touches our SQLite — it flows through to NFPT in memory only. Use this when you want to reconcile a wallet at a point in time. Priced at $0.50 / call at the REST surface.

ParametersJSON Schema
NameRequiredDescriptionDefault
chainYesWhich privacy chain to scan.
addressYesAddress whose notes you want.
viewKeyYesMonero: 64-hex private view key. Zcash: UFVK starting with uview1.
toHeightNoStop scanning at this block height. Defaults to chain tip.
includeNotesNoInclude a per-note breakdown (value/height/tx_hash/spent) in the response. Default false — totals only.
birthdayHeightNoSkip scanning earlier blocks. Zcash auto-detects when omitted (slower but always correct).
Behavior4/5

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

With no annotations, the description carries full burden and discloses that the view key never touches SQLite and is processed in memory only, plus pricing information.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, each valuable: purpose, privacy guarantee, usage and pricing. No redundancy, front-loaded with core information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite no output schema or annotations, the description covers privacy, pricing, default behaviors, and key parameter nuances, making it largely complete for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% (baseline 3). The description adds key details like view key format, default for includeNotes, and auto-detection for birthdayHeight, exceeding schema.

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

Purpose5/5

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

The description clearly states the tool returns spendable and spent notes for a view key without setting up a watch, distinguishing it from sibling watch-related tools.

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

Usage Guidelines4/5

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

Explicitly says 'use this when you want to reconcile a wallet at a point in time,' providing clear context, though it does not mention when not to use it or list alternatives.

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

seneschal_private_watch_infoPrivate watch — service metadataAInspect

Returns the current price, supported chains, NFPT upstream health, and security notes for the view-key payment-monitoring service. Free to call.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Behavior2/5

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

No annotations provided, so description must cover behavioral traits. It states 'Free to call' suggesting no cost, but does not disclose rate limits, authentication needs, or side effects. The read-only nature is implied but 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.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences. First sentence clearly states purpose, second adds cost note. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a parameter-less info tool with no output schema, the description fully covers what is returned (price, chains, health, security notes). No critical missing details.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema has zero parameters with 100% coverage. No parameter explanation needed; description adds nothing beyond schema but baseline is 4 due to no parameters.

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

Purpose5/5

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

The description clearly states returns specific metadata (price, chains, health, security notes) for the view-key payment-monitoring service. It distinguishes from sibling tools like seneschal_private_watch_create (creation) and seneschal_private_watch_historical (history).

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

Usage Guidelines3/5

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

The description mentions 'Free to call' but does not explicitly state when to use this tool versus alternatives. It implies use for retrieving service metadata but lacks explicit when-not or alternative guidance.

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

seneschal_private_watch_topupTop up an existing watch (paid via x402 at REST)AInspect

Add prepaid credit to an existing Private Watch. Three tiers — $0.10 (default), $1.00, and $5.00 — each settling at the matching REST path (/v1/private/topup, /topup-1, /topup-5). Credit is in atomic USDC ($0.02/day idle, $0.005/call). This tool returns the URL the agent should POST to with its x402 client; it does NOT settle payment itself.

ParametersJSON Schema
NameRequiredDescriptionDefault
tierNoTop-up size. 10c = $0.10 (≈5 days idle), 1 = $1.00 (≈50 days), 5 = $5.00 (≈250 days).10c
watchIdYesThe watchId returned from seneschal_private_watch_create.
watchTokenYesThe watchToken returned from seneschal_private_watch_create (constant-time compared at the REST surface).
Behavior4/5

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 that the tool does not settle payment itself, returns a URL, and describes the three tiers with costs and idle days. Could mention error scenarios or side effects, but overall transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, front-loaded with purpose, and contains no wasted words. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema, but description explains the return value (a URL). It covers tiers, costs, and links to sibling tools (watchId and watchToken from create). Could mention error handling, but adequate for a top-up tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% (all parameters have descriptions). The description adds context about tier costs and idle days, which complements the schema's enum descriptions.

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

Purpose5/5

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

Description states 'Add prepaid credit to an existing Private Watch', which is a specific verb+resource. It clearly distinguishes from sibling tools like seneschal_private_watch_create (creates a watch) and seneschal_private_watch_info (retrieves info).

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

Usage Guidelines4/5

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

Description explicitly says 'This tool returns the URL the agent should POST to with its x402 client; it does NOT settle payment itself', providing clear guidance on how to use the tool and its limitation. It does not explicitly mention when not to use it, but the context is sufficient.

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

seneschal_private_watch_topup_cryptoTop up an existing watch by paying in Monero or Zcash (FREE to quote)AInspect

Fund a Private Watch by paying in XMR or ZEC instead of USDC. Returns the FREE endpoint to call: POST /v1/private/topup-crypto issues a QUOTE — a receiving address, the exact coin amount to send (Monero: the amount carries a unique invoice tag; Zcash: a memo token), and a USD rate locked for a short window. Send the payment, then poll GET /v1/private/topup-crypto/{quoteId} (header x-watch-token) until status=settled. We detect the payment with the same view-key scanner the product sells and never hold a spend key. No x402, no API key — you pay in coin.

ParametersJSON Schema
NameRequiredDescriptionDefault
chainYesWhich privacy coin you will pay in.
watchIdYesThe watchId returned from seneschal_private_watch_create.
watchTokenYesThe watchToken returned from seneschal_private_watch_create.
amountUsdCentsYesCredit to buy, in US cents (e.g. 500 = $5.00). Min/max enforced server-side; see seneschal_private_watch_info -> crypto_topup.
Behavior4/5

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

With no annotations, the description carries the burden. It discloses the quote generation, payment detection method, and security assurances (no spend key, no API key). Missing explicit mention of write nature, but implied.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences with good front-loading. Some details (like polling endpoint) could be trimmed, but overall efficient and well-organized.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description fully covers the return value (quote with address, amount, rate) and subsequent steps (polling). No missing information for an 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.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

All 4 parameters are documented in schema (100% coverage). The description adds value by explaining the use of watchId/watchToken from creation, the meaning of amountUsdCents, and details about unique invoice tag for Monero and memo token for Zcash.

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

Purpose5/5

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

The description clearly states the tool funds a Private Watch by paying in Monero or Zcash, distinguishing it from the sibling seneschal_private_watch_topup (likely USDC). The verb 'fund' and resource 'Private Watch' are specific.

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

Usage Guidelines4/5

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

The description explains when to use (pay with XMR/ZEC instead of USDC) and provides a clear step-by-step flow (quote, send, poll). However, it does not explicitly state when not to use or contrast with alternatives.

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

seneschal_qPenny Oracle: atomic single-fact endpoints (DeFi + privacy chains)AInspect

Atomic single-fact endpoints designed for tight agent loops. Each answers ONE yes/no or one number — sub-50ms, flat $0.001/call at the REST surface. Two families: (1) DeFi facts sourced from our SQLite + shadow-blocks recorder (liquidatable, at-risk-count, recent-liquidations, top-builder, builder-share, builder-bid, cheapest-flashloan, data-freshness); (2) privacy-chain facts sourced from Seneschal-operated full nodes — Monero (xmr/height, xmr/mempool, xmr/fee, xmr/last-block) and Zcash (zec/height, zec/mempool, zec/last-block). Consult /v1/q for per-question input lists and live chain availability.

ParametersJSON Schema
NameRequiredDescriptionDefault
paramsNoPer-question parameter object. DeFi questions take addr/protocol/window/builder/pct/etc. Privacy-chain questions currently take no params.
questionYesWhich atomic fact to ask. See description for the list. Privacy-chain questions use `xmr/<name>` or `zec/<name>`.
Behavior4/5

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

No annotations provided, so description carries full burden. Discloses sub-50ms latency, flat pricing, data sources (SQLite + shadow-blocks, full nodes). Does not mention read-only nature or error behavior, but adequate given simplicity.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is front-loaded with key features (atomic, fast, cheap) and well-structured. While it repeats enum values from schema, the list is helpful for quick reference. No wasted sentences.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given high schema coverage and no output schema, description explains return type (yes/no or number), data sources, and where to get details (/v1/q). Sufficiently complete for an atomic fact tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers both parameters (100% coverage). Description adds value by explaining parameter patterns per question family (e.g., DeFi takes addr/protocol), which is not in schema. Baseline 3 exceeded.

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

Purpose5/5

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

The description clearly states it provides 'atomic single-fact endpoints' answering one yes/no or number, listing two families (DeFi, privacy-chain). Distinguishes from siblings, which appear to be for more complex or bulk data.

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

Usage Guidelines4/5

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

States it's for 'tight agent loops' and 'consult /v1/q for per-question input lists,' implying simple, fast queries. Lacks explicit when-not-to-use or alternatives, but context is clear.

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

seneschal_recent_liquidationsRecent liquidationsAInspect

Liquidations observed in the recent past, including both ones won by other liquidators (outcome=won_by_other) and ones we ourselves landed (outcome=we_landed). Sorted by timestamp descending.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax rows. Default 50, max 500.
protocolNoRestrict to one protocol.
since_msNoUnix epoch milliseconds. Defaults to now − 24h.
Behavior3/5

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

No annotations provided, so description carries burden. It explains data content, outcome categories, and sorting order, but lacks details on read-only nature, pagination, or performance. Adequate but not extensive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no fluff. Front-loaded with purpose and key details. Every sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given three optional parameters, no output schema, and several siblings, the description covers data type, sorting, and outcome categories. Could mention default limit or protocol filtering but schema handles that. Adequately complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. Description adds value by explaining the outcome classification in the data, which is not in parameter descriptions. This enhances understanding beyond the schema.

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

Purpose5/5

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

Description clearly states it lists recent liquidations, distinguishes between outcomes, and specifies sorting. It is specific and distinguishes from sibling tools like list_borrowers.

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

Usage Guidelines3/5

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

No explicit when-to-use or alternatives, but the context of liquidations and outcomes implies usage for tracking liquidation outcomes. Sibling list is present but no comparative guidance.

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

seneschal_stats_overviewPublic stats overviewAInspect

Aggregate snapshot powering the public stats dashboard at stats.seneschal.space: total positions tracked, debt under watch, HF distribution histogram, top-10 at-risk borrowers, 30-day liquidations-per-day series, builder market share for 24h/7d/30d windows, and 10 most recent on-chain liquidations. One call returns everything needed to render the dashboard.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Behavior3/5

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 lists return data but does not disclose behavioral traits like data freshness, caching, or whether it queries live data. Being a read-only snapshot is implied but 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.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that efficiently conveys the tool's purpose and output. While it is a bit long due to listing many items, it remains clear and front-loaded with the key idea 'Aggregate snapshot.'

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given zero parameters and no output schema, the description is remarkably complete. It enumerates all the data components needed to render a dashboard, leaving no ambiguity about what the tool returns. The sibling tools cover specific sub-queries, making this complete for its intended use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, so the description doesn't need to explain parameters. It adds value by detailing the exact metrics returned (e.g., total positions, debt under watch, HF histogram), which compensates for the lack of output schema.

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

Purpose5/5

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

The description clearly states the tool provides an 'Aggregate snapshot' for the public stats dashboard, listing specific data points. It distinguishes itself from sibling tools like seneschal_list_borrowers or seneschal_get_borrower by being a one-call overview.

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

Usage Guidelines4/5

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

The description explicitly says 'One call returns everything needed to render the dashboard,' indicating when to use it. It implies that for specific details (e.g., individual borrower info) sibling tools are appropriate, though not stated explicitly.

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

Discussions

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

Try in Browser

Your Connectors

Sign in to create a connector for this server.

Resources