Skip to content
AGENT ACCESS

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.

Service is upVersion 4.0.0Anonymous, read-only · no key
REST API · 4.0.0

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.

First request
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.

CategoryRequest parameter
Policy and lawcategory=policy
Clinical trialscategory=trials
Paperscategory=paper
Safetycategory=safety
Industrycategory=industry
Opinioncategory=opinion

Use less, get it faster

  1. 01
    Turn on compression

    Add --compressed to curl, or turn on gzip or br in other clients. Compressed JSON is a quarter to an eighth of the size.

  2. 02
    Send 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.

  3. 03
    Fetch 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

PathWhat it is forHow often to fetch
Items
/api/v1/itemsTop picks or all updates from the past 7 days, filtered by category, time window or keywordAt most once a minute
Hot topics and stories
/api/v1/hot-topicsThe current hot ranking top 10At most once a minute
/api/v1/stories/{publicId}One story's report timeline, AI overview and related storiesWhen needed
Daily brief
/api/v1/dailies/latestThe latest daily briefOnce after it comes out (every day at 05:00)
/api/v1/dailies/{date}The daily brief for a given date. Retractions remove the referenceCheck the ETag before use once the cache expires
/api/v1/dailiesIndex of daily brief datesOnce a day
Weekly and monthly reviews
/api/v1/weeklies/latestThe latest weekly review: lead story, overview and the week's key points, sorted by sectionOnce 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 referenceCheck the ETag before use once the cache expires
/api/v1/weekliesIndex of weekly reviewsOnce a week
/api/v1/monthlies/latestThe latest monthly reviewOnce after it comes out (on the 1st of each month at 07:30)
/api/v1/monthlies/{month}A given month, such as 2026-09Check the ETag before use once the cache expires
/api/v1/monthliesIndex of monthly reviewsOnce a month
For AI assistants
/api/v1/agentInstructions for agents. The addresses it lists return ready-made MarkdownWhen needed
Full top picks sync
/api/v1/selected/snapshotAll current top picks, paged so you can take the lot in one goFirst time only
/api/v1/selected/changesAdditions, edits and removals after thatEvery few minutes

Common uses

bash
# 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.