Connect Psychedelic Monitor to your agent
MCP, RSS, API: three ways to read the same data, which is top picks, hot topics and the daily, weekly and monthly reports. Pick the one that suits your tool. All are anonymous and read-only, with no sign-up and no API key.
Anonymous GET, ready to use
No token needed. Cross-origin browser requests, curl and the default HTTP client in any language can call it directly. The path is /api/v1, and the OpenAPI definition is the reference for fields and error codes.
curl --compressed 'https://psychedelicmonitor.com/api/v1/items?mode=selected&window=24h&limit=20'Filter by category
Add category to an items request to get that category only. Leave it out to include every category. The category on returned items uses the values in the table below.
| Category | Request parameter |
|---|---|
| Policy and law | category=policy |
| Clinical trials | category=trials |
| Papers | category=paper |
| Safety | category=safety |
| Industry | category=industry |
| Opinion | category=opinion |
Use less, get it faster
- 01Turn on compression
Add
--compressedto curl, or turn on gzip or br in other clients. Compressed JSON is a quarter to an eighth of the size. - 02Send the ETag
Keep the ETag from the response and send it next time as
If-None-Match. When nothing has changed you get a 304 with no body. - 03Fetch at the right pace
Items and hot topics at most once a minute. The daily brief once after it comes out (every day at 05:00), the weekly and monthly reviews once after each comes out. When paging back, stop at the first item you already have.
How often content changes: new items arrive all day, top picks change from a few to a few dozen times a day, and there is one daily brief every day at 05:00, one weekly review every Monday at 07:00 and one monthly review on the 1st of each month at 07:30 (Beijing time).
Endpoints
| Path | What it is for | How often to fetch |
|---|---|---|
| Items | ||
/api/v1/items | Top picks or all updates from the past 7 days, filtered by category, time window or keyword | At most once a minute |
| Hot topics and stories | ||
/api/v1/hot-topics | The current hot ranking top 10 | At most once a minute |
/api/v1/stories/{publicId} | One story's report timeline, AI overview and related stories | When needed |
| Daily brief | ||
/api/v1/dailies/latest | The latest daily brief | Once after it comes out (every day at 05:00) |
/api/v1/dailies/{date} | The daily brief for a given date. Retractions remove the reference | Check the ETag before use once the cache expires |
/api/v1/dailies | Index of daily brief dates | Once a day |
| Weekly and monthly reviews | ||
/api/v1/weeklies/latest | The latest weekly review: lead story, overview and the week's key points, sorted by section | Once after it comes out (every Monday at 07:00) |
/api/v1/weeklies/{week} | A given week, as an ISO week such as 2026-W39. Retractions remove the reference | Check the ETag before use once the cache expires |
/api/v1/weeklies | Index of weekly reviews | Once a week |
/api/v1/monthlies/latest | The latest monthly review | Once after it comes out (on the 1st of each month at 07:30) |
/api/v1/monthlies/{month} | A given month, such as 2026-09 | Check the ETag before use once the cache expires |
/api/v1/monthlies | Index of monthly reviews | Once a month |
| For AI assistants | ||
/api/v1/agent | Instructions for agents. The addresses it lists return ready-made Markdown | When needed |
| Full top picks sync | ||
/api/v1/selected/snapshot | All current top picks, paged so you can take the lot in one go | First time only |
/api/v1/selected/changes | Additions, edits and removals after that | Every few minutes |
Common uses
# First time: keep the ETag from the response headers
curl --compressed -i 'https://psychedelicmonitor.com/api/v1/items?mode=selected&window=24h&limit=20'
# After that, at most once a minute, send the ETag. A 304 means nothing changed
curl --compressed -i -H 'If-None-Match: <last ETag>' 'https://psychedelicmonitor.com/api/v1/items?mode=selected&window=24h&limit=20'To page back, send page.nextCursor as the cursor and stop at the first item you already have. Do not page through all 7 days every time.
When something goes wrong
- 400
- Bad parameters: fix them using OpenAPI and the returned code, and do not switch to a wider query automatically. A cursor that is invalid or has left the time window returns invalid_cursor, so start again from the first page.
- 409
- snapshot_required: the changes cannot be continued safely, so take a full snapshot again.
- 429
- Too many requests: wait as Retry-After says and do not retry in parallel.
- 5xx
- Back off exponentially and use the last successful result for now. The public service has no SLA.
Anonymous access does not mean every use is permitted, see Terms of use.