API for developers

MCP server

An AI agent can use the same data through MCP at https://psilocybincenters.fyi/mcp. It takes POST only: a GET in a browser gives 405. The server uses Streamable HTTP, keeps no session and needs no key. It reads only. It has the same rate limit, the same public fields and the same credit line as the API. The server card describes it.

search_listings

: Search published psilocybin centers by text, place and category.

get_listing

: Get one published psilocybin center by its slug.

list_places

: List countries, regions and cities that have psilocybin centers.

list_categories

: List categories with their psilocybin center counts.

get_stats

: Get the number of published psilocybin centers, places and categories, and when the data last changed.

list_sources

: List where the psilocybin center data comes from, with the license and refresh of each source.

claude mcp add --transport http psilocybincenters https://psilocybincenters.fyi/mcp

{
  "mcpServers": {
    "psilocybincenters": {
      "url": "https://psilocybincenters.fyi/mcp"
    }
  }
}

curl -X POST "https://psilocybincenters.fyi/mcp" -H "content-type: application/json" -H "accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Responses

A successful response has data and meta. A list response also has page, with these fields:

limit

: items on each page.

total

: items that match.

nextCursor

: send it back as cursor, with the same filters and limit. It is null on the last page.

capped

: true when more items match than the cursor can reach.

fuzzy

: true when the items are close matches for q.

An error has error (a sentence), code and sometimes details. Branch on code: invalid_parameter, invalid_cursor, not_found, method_not_allowed, rate_limited, internal_error.

Rate limits and caching

Each client may send 300 requests in 60 seconds. Every GET response has RateLimit-Limit and RateLimit-Policy. Over the limit you get 429 with Retry-After: wait that many seconds. The limit is counted at each Cloudflare location.

A successful response sends Cache-Control: public, max-age=60, s-maxage=300, stale-while-revalidate=600 and an ETag. Send the ETag back as If-None-Match to get 304 with no body.

Credit and licenses

Show this credit line next to the data you display:

Data from Psilocybin Centers (https://psilocybincenters.fyi). Each record keeps the license of its source, listed in meta.sources. A listing is a record, not an endorsement.

Every response lists its sources in meta.sources. Keep a source's license when you reuse its records.

• Oregon Health Authority, Oregon Psilocybin Services Licensee Directory: license Public record under the Oregon Public Records Law (ORS 192); licensees consented to publication. Content is provided as is under the Oregon.gov Website Terms & Conditions. Attribution: Oregon Health Authority., refreshed monthly
• Colorado Natural Medicine Division, Healing Center Directory: license Colorado Department of Revenue Open Data Use Terms (https://cdor.colorado.gov/department-of-revenue-open-data-use-terms). Republished rows carry the state disclaimer: "The data made available here may have been modified for use from its original source, which is the State of Colorado. THE STATE OF COLORADO MAKES NO REPRESENTATIONS OR WARRANTY AS TO THE COMPLETENESS, ACCURACY, TIMELINESS, OR CONTENT OF ANY DATA MADE AVAILABLE THROUGH THIS SITE. THE STATE OF COLORADO EXPRESSLY DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. The data is subject to change as modifications and updates are complete. It is understood that the information contained in the Web feed is being used at one's own risk." Attribution: Colorado Department of Revenue, Natural Medicine Division., refreshed monthly
• Psilocybin Centers editors: license All rights reserved, refreshed manual