nostr_query_events
Query Nostr events from a relay pool using NIP-01 filters. Supports filter by kind, author, time, and tags.
Instructions
Query events from the configured relay pool using NIP-01 filters. Supports kinds, authors, since/until/limit, and tag filters (#e, #p, #d, #t). Returns an array of events as plain objects (id, kind, pubkey, created_at, content, tags, sig). The workhorse read tool.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| d_tag | No | Filter for addressable events with these `d` tag values. Maps to NIP-01 `#d`. | |
| e_tag | No | Filter for events tagging these event IDs (hex). Maps to NIP-01 `#e`. | |
| kinds | No | Filter by event kind numbers (e.g. [0, 1, 30017]). | |
| limit | No | Max events to return. Default 50, hard cap 500. | |
| p_tag | No | Filter for events tagging these pubkeys (hex). Maps to NIP-01 `#p`. | |
| since | No | Unix timestamp (seconds). Only events at or after this time. | |
| t_tag | No | Filter for events with these hashtag `t` values. Maps to NIP-01 `#t`. | |
| until | No | Unix timestamp (seconds). Only events at or before this time. | |
| authors | No | Filter by author pubkeys (32-byte hex). |