search_events

Use this when a user wants current events from live UPlayground inventory using filters such as city, date, genre, vibe, venue, artist, neighborhood, or price.

Server Events uplayground-events
Category Read
Risk class Low
Parameters 120 required

What search_events does on Events

AI agents call search_events to retrieve information from Events without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

ParameterTypeRequiredDescription
city string City name, for example berlin or new york.
free boolean
vibe array
when string Date preset: today, tonight, tomorrow, weekend, week, this week, any, or YYYY-MM-DD.
avoid array Terms to penalize in recommendations.
limit number Results per page (default 12). The response's count field is the TOTAL matching events — raise limit or use offset to page through more.
pride boolean
query string Keyword search.
venue string
genres array
offset number
date_to string Inclusive end date in YYYY-MM-DD format.

Parameters from the server's own tool schema.

Why search_events needs a policy

This tool retrieves event data based on user-supplied search criteria (city, date, genre, etc.). It performs no writes, deletions, or financial transactions. Even if an AI agent misuses it by searching for irrelevant events, the blast radius is minimal—only read access to publicly discoverable event information. Severity is low because there are no destructive, financial, or code-execution implications.

From the tool's definition Tool description states it searches 'current events from live UPlayground inventory using filters'—a pure retrieval operation with no modification, deletion, or execution of external commands.

Risk signalsHigh parameter count (20 properties)

Questions about search_events

What does the search_events tool do? +

Use this when a user wants current events from live UPlayground inventory using filters such as city, date, genre, vibe, venue, artist, neighborhood, or price. It is categorised as a Read tool in the Events MCP Server, which means it retrieves data without modifying state.

What parameters does search_events accept? +

search_events accepts 12 parameters: city, free, vibe, when, avoid, limit, pride, query, venue, genres, offset, date_to. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on search_events? +

Register the Events MCP server in PolicyLayer and add a rule for search_events: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Events. Nothing to install.

What risk level is search_events? +

search_events is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit search_events? +

Yes. Add a rate_limit block to the search_events rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block search_events completely? +

Set action: deny in the PolicyLayer policy for search_events. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides search_events? +

search_events is provided by the Events MCP server (uplayground-events). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// THE FULL RECORD

search_events is one line of Events's registry record.

The record carries the whole server: verified identity, auth posture, risk grade, every tool classified, recommended policy — re-checked continuously.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.