Skip to main content
Glama

Polymarket Arbitrage

polymarket_arbitrage
Read-onlyIdempotent

Find arbitrage opportunities on Polymarket via monotonicity violations + partition-sum checks. Call with NO args for a trending_scan of the top ~200 markets by weekly volume; pass event for the strongest per-event partition_check, or topic for a themed cross-event scan. event (recommended for a specific market): pass a Polymarket event slug like "fed-decision-may-2026" or "when-will-bitcoin-hit-150k"; walks child markets, checks date-axis / threshold-axis ordering AND computes the partition_check (sum of YES prices across mutually-exclusive legs — should ≈1; deviations >3pp emit a BUY/SELL EVERY LEG signal). topic (for cross-event scanning): pass a seed question like "Strait of Hormuz traffic returns to normal" or "Fed rate decision"; searches related events across the platform, flattens markets, runs the comparator on the union. Cross-event mode catches "...by May 31" vs "...by Jun 30" patterns that single-event misses. SEMANTIC ANCHOR: cross-event pairs require ≥0.30 Jaccard similarity on question tokens (prevents Powell-Fed-Pause being paired with Powell-DOJ-probe); skipped_low_similarity surfaces the rejected pair count. PARTITION FILTER: drops will-person-X / will-manager-Y / will-someone-else- placeholder slugs; partitions with >20% placeholder fraction return null arb signal. Response: opportunities[] (gap_pp, suggested_trade, reasoning, monotonicity violation context), and in event mode partition_check{sum_yes_prices, gap_from_1, placeholders_filtered, suggested_trade}. FILL CHECK: when the partition signal fires, arbitrage.fill_check prices it against live CLOB depth (theoretical_edge_pp_at_book vs realizable_edge_pp at 1000 shares/leg, thin_legs[]) — realizable_edge_pp ≤ 0 means the overround exists only at last-trade, not in the book; do not trade it. For custom sizing use polymarket_fill_risk.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
eventNoSingle-event mode (use this if you know the specific Polymarket event): event slug like "fed-decision-may-2026" or "when-will-bitcoin-hit-150k". Full Polymarket URLs also accepted.
topicNoCross-event mode (use this if you want to scan related events across the platform): a topic or seed question like "Fed rate decision" or "Strait of Hormuz traffic returns to normal". Tool searches Polymarket for related events and checks monotonicity across them.

TDQS

A4.9/5.0
Behavior5/5

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

Annotations already mark read-only/idempotent; description adds substantial behavior: partition_filter drops placeholder slugs and returns null for >20% placeholder fraction; fill_check prices against live CLOB depth and warns that realizable_edge_pp ≤ 0 should not be traded. It also describes the emitted BUY/SELL EVERY LEG signal on >3pp deviation.

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 long but densely packed; every sentence contributes technical behavior or usage nuance. It front-loads the core purpose in the first sentence but packs boundary conditions, filters, and output contracts into a single paragraph, making it somewhat harder to scan.

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 tool with no output schema, it describes response fields (opportunities[], gap_pp, partition_check, placeholders_filtered, thin_legs[]), explains failure/null cases, and gives usage recommendations. It also contextualizes the tool versus polymarket_fill_risk, covering both input and output semantics thoroughly.

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 coverage is 100%, but the description enriches both params: it provides concrete event slug examples, defines topic as a seed question, and explains the distinct algorithmic behavior for each mode (walking child markets vs. flattening related events). It also makes clear that omitting both args runs a trending scan.

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 opens with a specific verb+resource+method: 'Find arbitrage opportunities on Polymarket via monotonicity violations + partition-sum checks.' It distinguishes itself from siblings like polymarket_edges and polymarket_fill_risk by detailing exclusive mechanisms (monotonicity, partition sums) and enumerating modes (trending_scan, event, topic).

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 instructs when to call with no args for `trending_scan`, when to pass `event` (recommended for a specific market), and when to use `topic`. It names an alternative tool for custom sizing: 'use polymarket_fill_risk', and explains cross-event mode catches patterns single-event misses.

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.

TDQS

A3.5/5.0
Disambiguation2/5

Multiple tools have overlapping purposes: ask_pipeworx, ask_pipeworx_beta, and ask_pipeworx_grounded are nearly identical, and several Polymarket analysis tools (polymarket_arbitrage, polymarket_edges, polymarket_edge_tracker, polymarket_fill_risk, bet_research) blur together. The three ArcGIS tools are distinct, but they are drowned out by a large set of data-query and prediction-market tools with unclear boundaries.

Naming Consistency3/5

All tool names use snake_case, but the verb/noun pattern is mixed: some are command-style (query_layer, validate_claim), some are noun phrases (layer_info, entity_profile), and others are bare verbs (remember, forget). The naming is readable but not consistently patterned.

Tool Count2/5

34 tools is too many for a server named 'Arcgis Allegheny', especially since only three tools (search_datasets, layer_info, query_layer) relate to ArcGIS at all. The bulk of the tools address unrelated domains like Pipeworx data lookups and Polymarket betting, making the count excessive for the apparent purpose.

Completeness1/5

For a server focused on ArcGIS Allegheny County data, the surface is severely incomplete: only three read-only tools (search_datasets, layer_info, query_layer) cover the domain, and they lack operations like adding, updating, or deleting features. The remaining 31 tools are unrelated to GIS, so the server fails to provide a coherent or complete toolset for its stated purpose.