Skip to main content
Glama

search_marketplace

Search the public strategy marketplace -- the platform's own listings, which are digital-asset strategies on crypto pairs -- over every dimension the marketplace page filters on: free text, asset, timeframe, risk level, floors on return, IRR, Sharpe, Sortino, Calmar, gain-to-pain, win rate, trade count and trades per week, a drawdown ceiling, free-only, beats-benchmarks, the market regime the listing was backtested in, and any sort key. Every filter is applied by the platform; do not fetch a page and filter it yourself. Counts cover the platform's own listings; the marketplace page also merges NexusTrade partner listings, which are not searchable or adoptable here -- say so plainly when a total is compared with the page, never guess at caching or filters. Use it whenever the person wants strategies to try, compare, or adopt -- 'find me a', 'what is on the marketplace', 'best Sharpe on ETH'. To adopt one, call propose_adopt with its strategy_id; never tell the person a strategy is theirs off the back of a search.

[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]

Input Schema

NameRequiredDescriptionDefault
sortNoThe column to order by. Omitted, the marketplace's trending order.
assetNoAsset symbol, e.g. BTC or ETH.
limitNoMaximum results.
orderNodesc for best-first on that metric, asc for worst-first.desc
offsetNoPagination offset in the result units documented by the tool; zero starts the first page.
searchNoFree text matched against listing name, description and creator.
free_onlyNoKeep only listings with no subscription price.
risk_levelNoKeep listings at any of these risk levels, e.g. low, medium, high.
asset_classNoKeep listings in these asset classes. Platform listings are all digital_assets; stocks, options and futures exist only as NexusTrade partner listings the chat cannot reach.
candle_sizeNoDuration of one candle, e.g. 1h or 1d.
min_irr_pctNoKeep listings at or above this annualised IRR, in percent.
backtest_trendNoKeep listings backtested in this trend character, e.g. clean, choppy; or unclassified.
max_drawdown_pctNoKeep listings whose max drawdown is at or below this, in percent.
min_calmar_ratioNoKeep listings at or above this Calmar ratio.
min_sharpe_ratioNoKeep listings at or above this Sharpe ratio.
min_total_tradesNoKeep listings with at least this many trades.
min_win_rate_pctNoKeep listings at or above this win rate, in percent.
min_sortino_ratioNoKeep listings at or above this Sortino ratio.
backtest_directionNoKeep listings backtested in this market direction, e.g. bull, neutral or bear -- the band get_market_regime reports; or unclassified.
backtest_volatilityNoKeep listings backtested in this volatility band, e.g. low, medium, high; or unclassified.
min_trades_per_weekNoKeep listings trading at least this often, per week.
beats_all_benchmarksNoKeep only listings whose return beat BTC, ETH and the S&P over their own window.
min_total_return_pctNoKeep listings at or above this total return, in percent.
min_gain_to_pain_ratioNoKeep listings at or above this gain-to-pain ratio.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.5/5.0
Behavior5/5

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

With no annotations present, the description carries the full burden and does so: it discloses the per-call cost (0.005 USDC via x402 vs. free with an API key), that counts exclude partner listings, that the agent must not speculate about caching or filters, and that a search result never implies ownership. These are exactly the non-obvious behaviors an agent would otherwise get wrong.

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?

Front-loaded with purpose and the platform-applies-filters rule, which is the most load-bearing sentence. The long middle enumeration of every filter dimension duplicates the schema and bloats the paragraph, though the closing adoption and access sentences each earn their 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?

For a 24-parameter, zero-required search with no output schema, the description covers scope, cost, server-side filtering, and the adopt handoff. It stops short of describing the result shape or pagination semantics beyond the offset/limit params, which is a modest gap given no output schema exists.

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% and every parameter already has a self-describing entry, so the schema does the heavy lifting. The description's enumeration of filter dimensions (return, IRR, Sharpe, drawdown ceiling, regime, free-only, etc.) largely restates the schema rather than adding syntax, ranges, or interaction rules, so the baseline 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?

States a specific verb and resource and pins down scope: 'the platform's own listings, which are digital-asset strategies on crypto pairs'. It explicitly separates itself from the marketplace page's merged NexusTrade partner listings and from adoption (propose_adopt), so an agent can distinguish it from siblings like get_marketplace_strategy or list_strategies.

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?

Gives concrete trigger phrases ('find me a', 'what is on the marketplace', 'best Sharpe on ETH'), a process rule ('do not fetch a page and filter it yourself'), and an explicit handoff for the adjacent intent ('To adopt one, call propose_adopt with its strategy_id'). It also states a when-not caveat about partner listings.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.