# Quorumz for agents

Quorumz is a geo-tagged news stream. The differentiator is the quorum: one story split into viewpoints, with the number of media, social, and on-the-ground posts supporting each viewpoint.

## Feeds

- Quorums: GET https://api.quorumz.com/api/agent/v1/quorums?country=LB
- Alpha: GET https://api.quorumz.com/api/agent/v1/events?stream=alpha&country=LB
- News, with the quorums on each article: GET https://api.quorumz.com/api/agent/v1/events?stream=news&country=LB
- One article: GET https://api.quorumz.com/api/agent/v1/articles/{article_id}

MCP server (streamable HTTP): https://api.quorumz.com/mcp — tools search_quorums, list_alpha_events, list_news, get_quorum, get_article, sample_quorum (free). Send the API key as Authorization: Bearer <key>.
Free sample: https://api.quorumz.com/api/agent/v1/sample
Catalog (free): https://api.quorumz.com/api/agent/v1
Discovery: https://api.quorumz.com/.well-known/x402
OpenAPI: https://api.quorumz.com/openapi.json
Docs: https://sense.quorumz.com/agents/docs
Skill: https://sense.quorumz.com/agents/skill.md
Landing: https://sense.quorumz.com/agents
Support: support@quorumz.com

## Two ways to pay

1. API key paid by credit card: https://sense.quorumz.com/agents/keys
2. x402 in USDC on Base, Polygon or Arbitrum, no account (see Payment).

## API key (credit card)

Get an API key at https://sense.quorumz.com/agents/keys (email sign-in, no card for the trial).
Send it as Authorization: Bearer <key>. The first 100 calls that return events,
within 7 days, are free; payment.trial in each response shows the calls left.
After the trial, calls are paid from prepaid credits your human buys by credit card (or PayPal) on that page
(payment.credits shows the balance); with no credits the call answers 402 and you pay as below.

## Payment

x402 exact, USDC. Every 402 accepts each of these networks; pay on the one you hold.
- Base (eip155:8453): asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Polygon (eip155:137): asset 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359
- Arbitrum (eip155:42161): asset 0xaf88d065e77c8cC2239327C5EDb3A432268e5831
payTo on all three: 0x9ce92953d33237af061c6b1aa29c597c8656b547
Alpha $0.02, news $0.005, quorum $0.01 per delivered event. An empty page is free.
An unpaid call that would return events responds HTTP 402 with a Base64 PAYMENT-REQUIRED header.
Retry with PAYMENT-SIGNATURE. The receipt is PAYMENT-RESPONSE.

## Filter

country is an ISO alpha-2 code. cell is a geohash of precision 3, 4, or 5.