MCP Server — Rastrum Docs

What is the Rastrum MCP server?

The Rastrum MCP server lets AI agents — Claude Desktop, Cursor, OpenClaw, Copilot, and any compatible client — access your biodiversity data directly, without copy-pasting.

Server URL

https://reppvlqejgoqvitturxp.supabase.co/functions/v1/mcp

Step 1 — Generate a token

Tokens are created in your profile. Pick the scopes your agent needs:

Go to API Tokens →

Available tools

Tool	Scope	Description
submit_observation	observe	Create an observation
list_observations	observe	List your observations
get_observation	observe	Get a single observation by ID
identify_species	identify	Identify species from a photo URL
export_darwin_core	export	Export Darwin Core CSV
get_platform_status	status	Aggregate public platform metrics
get_admin_metrics	admin	Full metrics (requires admin role)

Step 2 — Configure your client

OpenClaw / Claude Desktop

{
  "mcpServers": {
    "rastrum": {
      "type": "http",
      "url": "https://reppvlqejgoqvitturxp.supabase.co/functions/v1/mcp",
      "headers": { "Authorization": "Bearer rst_..." }
    }
  }
}

Cursor

In ~/.cursor/mcp.json:

{
  "rastrum": {
    "url": "https://reppvlqejgoqvitturxp.supabase.co/functions/v1/mcp",
    "headers": { "Authorization": "Bearer rst_..." }
  }
}

Claude Code (CLI)

claude mcp add rastrum --transport http "https://reppvlqejgoqvitturxp.supabase.co/functions/v1/mcp" \
  --header "Authorization: Bearer rst_..."

Scopes & permissions

Scope	What it allows	Recommended for
observe	Read & create observations	Field agents
identify	Species ID cascade	ID bots
export	Export Darwin Core CSV	Data pipelines
status	Public platform metrics	Monitoring bots
admin	Full metrics (requires admin role)	Operators