MCP Server Integration

Learn how to connect AI assistants like Cursor, Claude, and automation platforms like n8n to DumplingAI using the Model Context Protocol (MCP).

What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI assistants and automation tools to connect to external data sources and APIs. With DumplingAI’s MCP server, you can access all DumplingAI tools directly from your AI assistant or workflow automation platform.

Benefits

Direct tool access: Use DumplingAI tools without writing API integration code
AI assistant integration: Connect Cursor, Windsurf, Claude, and other MCP-compatible clients
Workflow automation: Build n8n workflows that leverage DumplingAI’s capabilities
Simplified development: Let AI assistants handle API calls and data processing

Prerequisites

Before you begin, make sure you have:

A DumplingAI account with an API key (get one here)
An MCP-compatible client (Cursor, Windsurf, Claude Desktop, Claude Code, or n8n)

Available Tools

DumplingAI’s MCP server provides access to tools across multiple categories:

Web Scraping & Data Extraction

scrape - Fetch structured data and HTML from URLs
crawl - Recursively scrape multiple pages
screenshot - Capture webpage screenshots
extract - Extract structured data using custom schemas

Search & Discovery

search - Perform live web searches with previews
search_maps - Search Google Maps locations
search_places - Find places and businesses
search_news - Search news articles
search_tiktok_users - Find TikTok users
get_autocomplete - Get search autocomplete suggestions
get_google_reviews - Fetch Google Business reviews
google_locations - Search Google location metadata

AI & Processing

generate_agent_completion - Build and interact with AI agents
generate_ai_image - Generate images using AI

YouTube: youtube_channel, youtube_channel_videos, youtube_channel_shorts, youtube_video, youtube_video_comments, youtube_search, get_youtube_transcript
TikTok: get_tiktok_profile, get_tiktok_profile_videos, get_tiktok_video, get_tiktok_video_comments, get_tiktok_transcript, get_tiktok_user_followers, get_tiktok_user_following, search_tiktok_users
LinkedIn: linkedin_profile, linkedin_company

Document Processing

doc_to_text - Extract text from documents
convert_to_pdf - Convert documents to PDF
merge_pdfs - Combine PDF files
read_pdf_metadata / write_pdf_metadata - Manage PDF metadata
extract_document - Extract structured data from documents
extract_pdf - Extract data from PDFs using AI
extract_audio - Extract data from audio files
extract_image - Extract data from images using AI vision
extract_video - Extract structured data from video files
trim_video - Trim video files

Developer Tools

run_js_code - Execute JavaScript code in a sandbox
run_python_code - Execute Python code in a sandbox

Quick Start

DumplingAI’s MCP server is hosted at https://mcp.dumplingai.com/mcp — no installation required. Just add your API key and start using it.

Method	Best For	Setup
Hosted HTTP	Cursor, Windsurf, Claude, n8n	⭐ URL + API key only

Hosted MCP Server (Recommended)

Connect to https://mcp.dumplingai.com/mcp with your API key. No installation required.

Claude Code CLI

claude mcp add --transport http dumplingai https://mcp.dumplingai.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "DumplingAI": {
      "url": "https://mcp.dumplingai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "DumplingAI": {
      "url": "https://mcp.dumplingai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "DumplingAI": {
      "serverUrl": "https://mcp.dumplingai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code + Copilot

Add to your VS Code settings.json:

{
  "mcp": {
    "servers": {
      "DumplingAI": {
        "url": "https://mcp.dumplingai.com/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

n8n Workflow Automation

In your n8n workflow, add an AI Agent node
Add an MCP Client Tool node
Create new MCP credentials:
- Connection Type: HTTP Streamable
- URL: https://mcp.dumplingai.com/mcp
- Authentication: Header Auth
  - Header Name: Authorization
  - Header Value: Bearer YOUR_API_KEY
Connect the MCP Client Tool to your AI Agent

Replace YOUR_API_KEY with your DumplingAI API key in all configurations above.

Example Use Cases

Web Research with AI Assistant

Ask your AI assistant in Cursor:

"Use the search tool to find recent news about AI developments,
then scrape the top 3 articles and summarize them"

The AI will:

Use the search tool to find relevant articles
Use the scrape tool to extract content from each article
Summarize the findings

Content Extraction Workflow in n8n

Build an n8n workflow that:

Receives a YouTube video URL
Uses youtube_video to fetch video details
Uses get_youtube_transcript to get the transcript
Uses generate_agent_completion to summarize the content
Saves the summary to your database

Ask your AI assistant:

"Find the top 5 TikTok creators in the fitness niche,
get their latest videos, and analyze their content strategy"

The AI will use multiple tools:

search_tiktok_users
get_tiktok_profile_videos
get_tiktok_video

Best Practices

API Key Security: Never commit your API key to version control. Use environment variables or secure credential storage.
Credit Management: Monitor your credit usage in the DumplingAI dashboard. Each tool call consumes credits based on the operation.
Rate Limits: Respect rate limits based on your subscription plan. Higher tiers offer increased rate limits.
Tool Selection: Use the most specific tool for your needs. For example, use youtube_search instead of generic search for YouTube content.
Error Handling: In n8n workflows, implement error handling nodes to manage API failures gracefully.

Troubleshooting

MCP Server Not Connecting

Solutions:

Verify your API key is correct and active in the dashboard
Check that the URL is exactly https://mcp.dumplingai.com/mcp (no trailing slash)
Ensure the Authorization header format is Bearer YOUR_API_KEY
Restart your MCP client after configuration changes
Check client logs for specific error messages

Tools Not Appearing

Solutions:

Verify the JSON configuration syntax is valid
Restart the client completely after configuration changes
For Claude Desktop, ensure developer mode is enabled in Settings

Rate Limit Errors (429)

Solutions:

Check your current usage in the DumplingAI dashboard
Upgrade your plan for higher rate limits
Implement delays between requests in automated workflows

Insufficient Credits

Solutions:

Check your credit balance in the dashboard
Upgrade to a plan with more credits
Enable auto-recharge in your account settings

Next Steps

Explore the API Reference for detailed tool documentation
Learn about AI Agents for advanced use cases
Check out Web Scraping for data extraction workflows

Support

Need help? Contact us at help@dumplingai.com

Guides

​MCP Server Integration

​What is MCP?

​Benefits

​Prerequisites

​Available Tools

​Web Scraping & Data Extraction

​Search & Discovery

​AI & Processing

​Social Media & Video Data

​Document Processing

​Developer Tools

​Quick Start

​Hosted MCP Server (Recommended)

​Claude Code CLI

​Claude Desktop

​Cursor

​Windsurf

​VS Code + Copilot

​n8n Workflow Automation

​Example Use Cases

​Web Research with AI Assistant

​Content Extraction Workflow in n8n

​Social Media Research

​Best Practices

​Troubleshooting

​MCP Server Not Connecting

​Tools Not Appearing

​Rate Limit Errors (429)

​Insufficient Credits

​Next Steps

​Support

MCP Server Integration

What is MCP?

Benefits

Prerequisites

Available Tools

Web Scraping & Data Extraction

Search & Discovery

AI & Processing

Social Media & Video Data

Document Processing

Developer Tools

Quick Start

Hosted MCP Server (Recommended)

Claude Code CLI

Claude Desktop

Cursor

Windsurf

VS Code + Copilot

n8n Workflow Automation

Example Use Cases

Web Research with AI Assistant

Content Extraction Workflow in n8n

Social Media Research

Best Practices

Troubleshooting

MCP Server Not Connecting

Tools Not Appearing

Rate Limit Errors (429)

Insufficient Credits

Next Steps

Support