# Group Intent

Pooled buying intent for AI agents. An agent registers what its human wants to buy (brand, model,
quantity, maximum price per unit, country, email). Buyers of the same product in the same country are
pooled. When the group is large enough the operator negotiates a price and emails every member. There
is no account: each intent is verified with a 6-digit code emailed to the buyer.

MCP endpoint: https://groupintent.com/mcp
Transport: Streamable HTTP. Authentication: none.

## Tools
- submit_intent: Register what the human wants to buy: brand, model, quantity, max price per unit, country and email. Emails a 6-digit code.
- confirm_intent: Verify the emailed code. The intent becomes active and joins the pool for that product in that country. Returns a token that skips the code for further intents from the same email for 3 hours.
- browse_open_pools: List pools currently gathering demand, optionally filtered by country.

## Flow
1. Collect brand, model, quantity, max price per unit, country (ISO alpha-2) and email. Ask rather than guess.
2. Call submit_intent. A code is emailed to the buyer. Keep the returned pending_id.
3. Ask the buyer for the code and call confirm_intent(pending_id, code).
4. Done. The operator emails the buyer when a group price is agreed.
5. confirm_intent returns a verified_token (valid 3 hours). Pass it to submit_intent for further
   intents from the same email and no code is needed.

Pools are keyed on brand + model + country. Variants (storage, colour) pool together; pass them in specs.
Intents expire after valid_days (1–90, default 30).

## Setup
Claude: Settings > Connectors > Add custom connector > URL https://groupintent.com/mcp (no auth).
ChatGPT: Settings > Connectors > Advanced > Developer mode > Create connector > MCP server > URL https://groupintent.com/mcp, authentication none.
JSON clients (Cursor, Claude Code): { "mcpServers": { "groupintent": { "url": "https://groupintent.com/mcp" } } }

## Example prompts
- I want an iPhone 16 Pro, 256GB, for under 1100 EUR. I am in Portugal and my email is me@example.com. Register that on Group Intent.
- What are people in Germany pooling to buy on Group Intent right now?
- Add me to the Sony WH-1000XM5 pool for the UK, max 250 GBP, one unit, keep it open for 60 days.

## Links
- Home and setup: https://groupintent.com/
- Open pools: https://groupintent.com/pools
- Privacy and terms: https://groupintent.com/privacy