How to Use the Planet Labs MCP in Cursor

Q: How do I query Planet Labs from Cursor?

Open Agent mode and ask it to run quicksearch with your target coordinates. The agent fetches the data and writes your script around the response.

Q: Can Cursor test Planet Labs webhooks locally?

Cursor uses createsubscription to route new imagery notifications. You point the destination to your local dev server using a tunneling service.

Q: How do I handle pagination in Planet Labs scripts with Cursor?

Tell Cursor to use getsearchresults with page size arguments. The agent will write the loop logic based on the actual returned metadata.

Q: Does this MCP Server support historical RapidEye data?

Yes. You pass 'RapidEye' to the item types filter in your quicksearch request to pull older archive records.

Build GIS pipelines in Cursor using this MCP Server for live Planet Labs imagery data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Planet Labs MCP to Cursor

Create your Vinkius account to connect Planet Labs to Cursor — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Planet Labs with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Inject live imagery data into Cursor

The `quick_search` tool pulls real PSScene and Sentinel-2 metadata straight into your editor. Your agent uses these live responses to write ingestion scripts that actually work against the current API schema. The `list_item_types` tool shows you exactly what properties exist on the backend. You stop guessing at data structures and let Cursor format your Python code to match the exact payload.

Script asset downloads

The `get_item_assets` tool returns signed download URLs and file sizes for specific satellite passes. Your agent uses this live data to write and test your download workers right in the IDE. The `get_item_details` tool fetches the exact acquisition conditions for a scene. Cursor uses this metadata to build logic that automatically rejects captures with bad sun elevation angles.

Build automated MCP Server pipelines

The `create_subscription` tool configures Planet to push new captures to your cloud buckets. You map out the GeoJSON boundaries, and Cursor writes the webhook handlers based on the actual subscription confirmation payload. The `create_saved_search` tool sets up the query on Planet's backend if you prefer polling over webhooks. Your code then just calls the results endpoint on a cron job to fetch the latest matching item IDs.

Setup guide

Set up Planet Labs MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Planet Labs MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Planet Labs transactions." If the MCP tools are loaded correctly, Cursor will call the Planet Labs tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "planet-labs-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Planet Labs. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Planet Labs now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Planet Labs MCP in Cursor

Open Agent mode and ask it to run `quick_search` with your target coordinates. The agent fetches the data and writes your script around the response.

Cursor uses `create_subscription` to route new imagery notifications. You point the destination to your local dev server using a tunneling service.

Tell Cursor to use `get_search_results` with page size arguments. The agent will write the loop logic based on the actual returned metadata.

Yes. You pass 'RapidEye' to the item types filter in your `quick_search` request to pull older archive records.

You only need one Vinkius endpoint token in your configuration. The server executes in a zero-trust isolate, ensuring your raw geographic queries and code remain completely disconnected from the underlying auth mechanisms.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript