Supadata MCP

How to Install and Use Supadata MCP

Supadata MCP is a powerful server tool that helps you extract video transcripts, scrape web pages, crawl websites, and map URLs. This guide will walk you through installing and using Supadata MCP with clear, easy-to-follow steps and code examples.

Installing Supadata MCP

First, let's get the tool installed on your computer. There are several ways to install Supadata MCP, but here are the easiest methods.

1. Running with npx (No Installation Needed)

If you want a quick test or don’t want to install anything permanently, you can run Supadata MCP directly with npx. You will need your Supadata API key to use it.

env SUPADATA_API_KEY=your-api-key npx -y @supadata/mcp

Just replace your-api-key with your actual Supadata API key. You can get this key by signing up at https://dash.supadata.ai.

2. Manual Installation with npm

If you prefer to install Supadata MCP on your system so you can use it anytime:

npm install -g @supadata/mcp

This command will install Supadata MCP globally on your computer.

Using Supadata MCP in Different Environments

Depending on where you want to use Supadata MCP, the setup slightly differs. Here are a few common environments.

1. Setting Up Supadata MCP in Cursor

Cursor is a tool that can use MCP servers like Supadata MCP for extra functions.

• Open Cursor settings.
• Go to Features > MCP Servers.
• Click + Add new global MCP server.
• Enter this setup code:

{
  "mcpServers": {
    "@supadata/mcp": {
      "command": "npx",
      "args": ["-y", "@supadata/mcp"],
      "env": {
        "SUPADATA_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Remember to swap "YOUR-API-KEY" with your real Supadata API key. After saving, refresh the MCP server list and Supadata MCP will be ready to use.

2. Running on Windsurf

To run Supadata MCP on Windsurf, add this block to your ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "@supadata/mcp": {
      "command": "npx",
      "args": ["-y", "@supadata/mcp"],
      "env": {
        "SUPADATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Replace "YOUR_API_KEY" with your API key.

3. Using Supadata MCP in VS Code

To quickly install Supadata MCP in Visual Studio Code with one click, you can use the install buttons provided on the website. For manual setup, add this JSON configuration to your User Settings (JSON):

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Supadata API Key",
        "password": true
      }
    ],
    "servers": {
      "supadata": {
        "command": "npx",
        "args": ["-y", "@supadata/mcp"],
        "env": {
          "SUPADATA_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

You can also add the same setup to a .vscode/mcp.json file in your workspace if you want to share the config with your team.

How to Use Supadata MCP Tools

After installing, you can use different tools based on your needs. Here are some example uses.

Getting a Transcript from a Video

Use this code to get a transcript from a YouTube video:

{
  "name": "supadata_transcript",
  "arguments": {
    "url": "https://youtube.com/watch?v=example",
    "lang": "en",
    "text": false,
    "mode": "auto"
  }
}

Replace the video URL with the one you want to analyze.

Scraping a Single Web Page

If you want to get content from one webpage, use this example:

{
  "name": "supadata_scrape",
  "arguments": {
    "url": "https://example.com",
    "noLinks": false,
    "lang": "en"
  }
}

This will fetch the page content as markdown.

Mapping URLs on a Website

To find all URLs on a website:

{
  "name": "supadata_map",
  "arguments": {
    "url": "https://example.com"
  }
}

This tool helps you discover what pages exist before scraping or crawling.

Final Notes

Always replace placeholders like YOUR-API-KEY and URLs with your real values. Supadata MCP automatically handles retries and rate limiting, so you don’t need to worry about those. Just pick the right tool for your task and run the commands easily.

Now you’re ready to install and use Supadata MCP for video transcription and web content extraction!