# FeedIRL
> FeedIRL is a discovery and attribution layer for real-world events and experiences. AI agents can search upcoming events by city, date, and interests, and send people to ticketing or venue pages. FeedIRL does not sell tickets, reserve tickets, or process payments.

## Discovery API
- Docs: https://www.feedirl.com/api/v1/discover/docs/
- OpenAPI spec: https://www.feedirl.com/api/v1/discover/openapi.json
- Endpoint: GET https://www.feedirl.com/api/v1/discover
- MCP tool: POST https://www.feedirl.com/api/v1/discover/mcp (tool name: discover_events)
- Query by city or lat/lng + radius_mi, date/end_date, interests, category, budget. Results include per-field confirmed/unavailable status — treat unavailable fields as unknown, and never claim a ticket is reserved or purchased unless the seller confirms it. Prefer the referral_url in each result for outbound links; promoted listings are flagged is_promoted. Adult listings are excluded by default (include_adult=true to allow).

## Optional
- Public event pages with schema.org Event markup: https://www.feedirl.com/e/{id}
- Partner conversion webhook: POST https://www.feedirl.com/api/v1/discover/conversions
- Contact: support@feedirl.com