Strands Resident Advisor

Query Resident Advisor's GraphQL API with Strands Agents.

Documentation ◆ Python SDK ◆ Tools ◆ Community Packages

A Strands Agents tool that provides direct access to Resident Advisor's public GraphQL API for querying electronic music events, artists, venues, and more. No authentication required.

Installation

pip install strands-resident-advisor

Quick start

from strands import Agent
from strands_resident_advisor import use_resident_advisor

agent = Agent(tools=[use_resident_advisor])

agent("Find electronic music events in Berlin this weekend")
agent("Tell me about DJ Sprinkles")
agent("What's happening at Berghain?")

What it does

The tool executes GraphQL queries against ra.co/graphql. The agent constructs the queries based on user intent — the tool just runs them.

Available queries include:

• eventListings — Search events with filters (area, date, genre, etc.)
• event(id) — Get event details
• artist(slug) — Get artist profile
• venue(id) — Get venue details
• search(searchTerm) — Universal search across events, artists, venues, promoters
• areas(searchTerm) — Look up area codes by city name

Development

pip install -e ".[dev]"
hatch run prepare  # format, lint, typecheck, test

License

Apache 2.0 — see LICENSE for details.