---
title: "Cursor · Scrape.ly Docs"
description: "Add Scrape.ly to Cursor in one click."
url: https://scrape.ly/docs/cursor
markdown: https://scrape.ly/docs/cursor.md
---

# Cursor

> Add Scrape.ly to Cursor in one click.

Add Scrape.ly to Cursor: in the Agent chat, Cursor can search the Store, run Actors, wait for their runs, and read the results while you code. It connects to the hosted [MCP server](https://scrape.ly/docs/mcp.md), so there is nothing to install beyond Cursor.

## Add the server

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=scrapely&config=eyJ1cmwiOiJodHRwczovL21jcC5zY3JhcGUubHkifQ%3D%3D)

The link opens Cursor with the server filled in. Click **Install**, then sign in when Cursor shows the `scrapely` server in its MCP settings: a dashboard window opens where you approve access, so there is no token to copy.

To add it by hand, put the server in `~/.cursor/mcp.json` (every project) or `.cursor/mcp.json` (one project):

```json
{
  "mcpServers": {
    "scrapely": {
      "url": "https://mcp.scrape.ly"
    }
  }
}
```

### Use an API key instead

To skip the sign-in, or to cap spending, add a key from **Settings → API & Integrations** in the [dashboard](https://my.scrape.ly) as a header:

```json
{
  "mcpServers": {
    "scrapely": {
      "url": "https://mcp.scrape.ly",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
```

Cursor can do anything the key can, including starting paid runs, so give it a scoped key: `actors:run`, `runs:read`, and `datasets:read`, with a **Max charge per day**. See [API keys & permissions](https://scrape.ly/docs/api-keys.md). Don't commit a project's `.cursor/mcp.json` with a key in it.

## Use it in a chat

Open the **Agent** chat and ask:

```text
Find an Actor that scrapes Google Maps, run it for 'coffee shops in Berlin' with at most 20 results, and save the name, rating, and address of each place to places.json.
```

Cursor asks before each tool call unless you allow it to run tools on its own.

## What the agent can do

The agent gets the MCP server's default tools. The ones used most:

| Tool | What it does |
| --- | --- |
| `search-actors` | Find Actors in the Store by keywords. |
| `fetch-actor-details` | Read an Actor's input schema, README, and pricing before running it. |
| `call-actor` | Run an Actor with a JSON input, optionally with `maxItems` and `maxTotalChargeUsd`. |
| `get-actor-run` | Wait for a run and check its status. |
| `get-actor-output` | Read a run's results, paged and kept compact. |

The full list, including saved inputs and automations, is on the [MCP server](https://scrape.ly/docs/mcp.md#tools) page. To run one Actor you already know, name it in the prompt, for example `Run username/actor-name`, so the agent skips the search.

**Costs**: runs started by the agent are billed like any run. Put the limits in the prompt (such as "at most 20 results"). A **Max charge per day** applies only to [API keys](https://scrape.ly/docs/api-keys.md), not to an OAuth sign-in.

---

- Previous: [Claude Code](https://scrape.ly/docs/claude-code.md)
- Next: [VS Code](https://scrape.ly/docs/vscode.md)
- All docs: [Docs index](https://scrape.ly/docs.md), [llms.txt](https://scrape.ly/llms.txt)