get_disputes
Reads dispute records from the Boson subgraph. Supports pagination, ordering, and filtering by buyer/seller/state. Read-only. Returns: array of dispute entities with exchangeId, state, timeout.
Category: Dispute management. Returns unsigned tx? No — read-only or returns signed payload.
Input schema
| Field | Type | Required | Description |
|---|---|---|---|
disputesSkip | number | no | |
disputesFirst | number | no | |
disputesOrderBy | buyer | buyerPercent | buyer__active | buyer__id | buyer__wallet | decidedDate | disputeResolver | disputeResolver__active | disputeResolver__admin | disputeResolver__assistant | disputeResolver__clerk | disputeResolver__escalationResponsePeriod | disputeResolver__id | disputeResolver__metadataUri | disputeResolver__treasury | disputedDate | escalatedDate | exchange | exchangeId | exchange__cancelledDate | exchange__committedDate | exchange__completedDate | exchange__disputed | exchange__disputedDate | exchange__expired | exchange__finalizedDate | exchange__id | exchange__mutualizerAddress | exchange__redeemedDate | exchange__revokedDate | exchange__state | exchange__validUntilDate | finalizedDate | id | refusedDate | resolvedDate | retractedDate | seller | seller__active | seller__admin | seller__assistant | seller__authTokenId | seller__authTokenType | seller__clerk | seller__id | seller__metadataUri | seller__sellerId | seller__treasury | seller__voucherCloneAddress | state | timeout | no | |
disputesOrderDirection | asc | desc | no | |
disputesFilter | object | no | |
configId | string | yes | Boson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server. |
Related
- Reference → MCP tools — full catalogue.
- Build for AI agents → The 3-step signing pattern — what to do with returned unsigned transactions.
- Concepts → Signing & meta-transactions — canonical signing reference.