Documentation Index
Fetch the complete documentation index at: https://docs.dumplingai.com/llms.txt Use this file to discover all available pages before exploring further.

DumplingAI MCP Server

Use DumplingAI’s API through the Model Context Protocol (MCP). Connect any MCP-compatible AI client to DumplingAI’s full suite of tools — web scraping, search, social media data, document processing, and more.

Features

Web scraping, crawling, and screenshots
Federated web search, news, maps, and places
YouTube, TikTok, and LinkedIn data
Document processing (PDF, DOCX, audio, video, images)
AI-powered structured extraction
Code execution (JavaScript and Python sandboxes)
AI agent and image generation

Installation

The DumplingAI MCP server is hosted at https://mcp.dumplingai.com/mcp. No installation required — just add your API key. Get your API key from app.dumplingai.com.

Claude Code

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 VS Code settings.json (Ctrl+Shift+P → “Preferences: Open User Settings (JSON)”):

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

n8n

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 from app.dumplingai.com.

Available Tools

Web Scraping & Extraction

`scrape`

Fetch structured data and HTML from a URL.

{
  "name": "scrape",
  "arguments": {
    "url": "https://example.com",
    "format": "markdown",
    "clean": true,
    "render": false,
    "proxyCountry": "US",
    "includeLinks": false,
    "extractionPrompt": "Extract the main article content",
    "extractionSchema": {
      "type": "object",
      "properties": {
        "title": { "type": "string" },
        "body": { "type": "string" }
      }
    }
  }
}

`crawl`

Crawl a site and return captured pages with metadata.

{
  "name": "crawl",
  "arguments": {
    "url": "https://example.com/blog",
    "limit": 50,
    "maxDepth": 3,
    "format": "markdown"
  }
}

`screenshot`

Capture a screenshot of a web page.

{
  "name": "screenshot",
  "arguments": {
    "url": "https://example.com",
    "fullPage": true,
    "width": 1280,
    "height": 800
  }
}

`extract`

Extract structured data from a URL using AI.

{
  "name": "extract",
  "arguments": {
    "url": "https://example.com/product",
    "prompt": "Extract the product name, price, and description",
    "schema": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "price": { "type": "number" },
        "description": { "type": "string" }
      }
    }
  }
}

Search & Discovery

`search`

Perform a federated web search.

{
  "name": "search",
  "arguments": {
    "query": "latest AI news",
    "count": 5,
    "country": "US",
    "language": "en",
    "freshness": "week"
  }
}

`search_news`

Search Google News.

{
  "name": "search_news",
  "arguments": {
    "query": "electric vehicles 2025",
    "count": 10,
    "freshness": "day"
  }
}

`search_maps`

Search Google Maps.

{
  "name": "search_maps",
  "arguments": {
    "query": "coffee shops",
    "location": "San Francisco, CA"
  }
}

`search_places`

Search Google Places for businesses and points of interest.

{
  "name": "search_places",
  "arguments": {
    "query": "pizza restaurant",
    "location": "New York"
  }
}

`get_autocomplete`

Get Google search autocomplete suggestions.

{
  "name": "get_autocomplete",
  "arguments": {
    "query": "how to learn",
    "country": "US"
  }
}

`get_google_reviews`

Retrieve Google Business reviews.

{
  "name": "get_google_reviews",
  "arguments": {
    "query": "Acme Coffee San Francisco",
    "count": 20
  }
}

`google_locations`

Search for Google location metadata.

{
  "name": "google_locations",
  "arguments": {
    "query": "New York",
    "country": "US"
  }
}

YouTube

`get_youtube_transcript`

Get the transcript for a YouTube video.

{
  "name": "get_youtube_transcript",
  "arguments": {
    "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "language": "en"
  }
}

`youtube_video`

Fetch metadata for a YouTube video.

{
  "name": "youtube_video",
  "arguments": {
    "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  }
}

`youtube_video_comments`

List comments for a YouTube video.

{
  "name": "youtube_video_comments",
  "arguments": {
    "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "limit": 50,
    "sortBy": "top"
  }
}

`youtube_channel`

Fetch YouTube channel metadata.

{
  "name": "youtube_channel",
  "arguments": {
    "channelUrl": "https://www.youtube.com/@mkbhd"
  }
}

`youtube_channel_videos`

List a channel’s long-form videos.

{
  "name": "youtube_channel_videos",
  "arguments": {
    "channelUrl": "https://www.youtube.com/@mkbhd",
    "limit": 20
  }
}

`youtube_channel_shorts`

List a channel’s Shorts.

{
  "name": "youtube_channel_shorts",
  "arguments": {
    "channelUrl": "https://www.youtube.com/@mkbhd",
    "limit": 20
  }
}

`youtube_search`

Search YouTube.

{
  "name": "youtube_search",
  "arguments": {
    "query": "machine learning tutorial",
    "type": "video",
    "limit": 10
  }
}

TikTok

`get_tiktok_profile`

Fetch a TikTok profile.

{
  "name": "get_tiktok_profile",
  "arguments": {
    "username": "@charlidamelio"
  }
}

`get_tiktok_profile_videos`

List recent videos for a TikTok profile.

{
  "name": "get_tiktok_profile_videos",
  "arguments": {
    "username": "@charlidamelio",
    "limit": 20
  }
}

`get_tiktok_transcript`

Get the transcript for a TikTok video.

{
  "name": "get_tiktok_transcript",
  "arguments": {
    "videoUrl": "https://www.tiktok.com/@user/video/1234567890"
  }
}

`get_tiktok_video`

Fetch details for a TikTok video.

{
  "name": "get_tiktok_video",
  "arguments": {
    "videoUrl": "https://www.tiktok.com/@user/video/1234567890"
  }
}

`get_tiktok_video_comments`

Get comments for a TikTok video.

{
  "name": "get_tiktok_video_comments",
  "arguments": {
    "videoUrl": "https://www.tiktok.com/@user/video/1234567890",
    "limit": 50
  }
}

`get_tiktok_user_followers`

Get followers for a TikTok account.

{
  "name": "get_tiktok_user_followers",
  "arguments": {
    "username": "@charlidamelio",
    "limit": 100
  }
}

`get_tiktok_user_following`

Get accounts a TikTok user follows.

{
  "name": "get_tiktok_user_following",
  "arguments": {
    "username": "@charlidamelio",
    "limit": 100
  }
}

`search_tiktok_users`

Search for TikTok users.

{
  "name": "search_tiktok_users",
  "arguments": {
    "query": "fitness influencer",
    "limit": 10
  }
}

`linkedin_profile`

Retrieve a LinkedIn profile.

{
  "name": "linkedin_profile",
  "arguments": {
    "profileUrl": "https://www.linkedin.com/in/satyanadella"
  }
}

`linkedin_company`

Retrieve a LinkedIn company profile.

{
  "name": "linkedin_company",
  "arguments": {
    "companyUrl": "https://www.linkedin.com/company/microsoft"
  }
}

Document Processing

`doc_to_text`

Convert a PDF or DOCX to plain text.

{
  "name": "doc_to_text",
  "arguments": {
    "fileUrl": "https://example.com/report.pdf"
  }
}

`convert_to_pdf`

Convert a document or web page to PDF.

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

`merge_pdfs`

Merge multiple PDFs into one.

{
  "name": "merge_pdfs",
  "arguments": {
    "fileUrls": [
      "https://example.com/page1.pdf",
      "https://example.com/page2.pdf"
    ]
  }
}

`read_pdf_metadata`

Read metadata from a PDF.

{
  "name": "read_pdf_metadata",
  "arguments": {
    "fileUrl": "https://example.com/document.pdf"
  }
}

`write_pdf_metadata`

Update metadata in a PDF.

{
  "name": "write_pdf_metadata",
  "arguments": {
    "fileUrl": "https://example.com/document.pdf",
    "title": "Annual Report 2025",
    "author": "Finance Team"
  }
}

`extract_document`

Extract structured data from a document.

{
  "name": "extract_document",
  "arguments": {
    "fileUrl": "https://example.com/contract.pdf",
    "prompt": "Extract the parties, effective date, and key terms",
    "schema": {
      "type": "object",
      "properties": {
        "parties": { "type": "array", "items": { "type": "string" } },
        "effectiveDate": { "type": "string" },
        "keyTerms": { "type": "array", "items": { "type": "string" } }
      }
    }
  }
}

`extract_pdf`

Extract structured data from a PDF using AI.

{
  "name": "extract_pdf",
  "arguments": {
    "fileUrl": "https://example.com/invoice.pdf",
    "prompt": "Extract invoice number, date, and total amount"
  }
}

`extract_image`

Extract data from an image using AI vision.

{
  "name": "extract_image",
  "arguments": {
    "imageUrl": "https://example.com/chart.png",
    "prompt": "Describe the data shown in this chart"
  }
}

`extract_audio`

Extract structured data from an audio file.

{
  "name": "extract_audio",
  "arguments": {
    "fileUrl": "https://example.com/meeting.mp3",
    "prompt": "Summarize the key decisions made in this meeting"
  }
}

`extract_video`

Extract structured data from a video file.

{
  "name": "extract_video",
  "arguments": {
    "fileUrl": "https://example.com/presentation.mp4",
    "prompt": "List the main topics covered in this video"
  }
}

`trim_video`

Trim a video to a specified duration.

{
  "name": "trim_video",
  "arguments": {
    "fileUrl": "https://example.com/video.mp4",
    "startTime": 10,
    "endTime": 60
  }
}

AI & Generation

`generate_agent_completion`

Build and interact with AI agents to automate complex tasks.

{
  "name": "generate_agent_completion",
  "arguments": {
    "messages": [
      { "role": "user", "content": "Research the top 5 competitors of Notion" }
    ]
  }
}

`generate_ai_image`

Generate an image from a text prompt.

{
  "name": "generate_ai_image",
  "arguments": {
    "prompt": "A futuristic city skyline at sunset, photorealistic",
    "width": 1024,
    "height": 1024
  }
}

Developer Tools

`run_js_code`

Execute JavaScript in a secure sandbox.

{
  "name": "run_js_code",
  "arguments": {
    "code": "const data = [1, 2, 3, 4, 5];\nconst sum = data.reduce((a, b) => a + b, 0);\nconsole.log('Sum:', sum);"
  }
}

`run_python_code`

Execute Python in a secure sandbox.

{
  "name": "run_python_code",
  "arguments": {
    "code": "import statistics\ndata = [1, 2, 3, 4, 5]\nprint('Mean:', statistics.mean(data))\nprint('Stdev:', statistics.stdev(data))"
  }
}

Authentication

All tool calls require a DumplingAI API key. Pass it as a Bearer token in the Authorization header when configuring your MCP client. Discovery operations (tools/list, initialize) work without authentication so clients can enumerate tools before connecting.

Error Handling

When a tool call fails, the response includes "isError": true and the body contains the error detail from the DumplingAI API:

{
  "content": [{ "type": "text", "text": "{\"error\": \"Insufficient credits\"}" }],
  "isError": true
}

Common errors:

Status	Meaning
401	Invalid or missing API key
402	Insufficient credits
429	Rate limit exceeded
5xx	DumplingAI API error

Credit Usage

Each tool call consumes credits. Check your balance and usage in the DumplingAI dashboard. See the credit costs reference for per-tool pricing.

Support

Need help? Contact us at help@dumplingai.com

Start Here

Tutorials

Core Features

Examples

​Documentation Index

​DumplingAI MCP Server

​Features

​Installation

​Claude Code

​Claude Desktop

​Cursor

​Windsurf

​VS Code + Copilot

​n8n

​Available Tools

​Web Scraping & Extraction

​scrape

​crawl

​screenshot

​extract

​Search & Discovery

​search

​search_news

​search_maps

​search_places

​get_autocomplete

​get_google_reviews

​google_locations

​YouTube

​get_youtube_transcript

​youtube_video

​youtube_video_comments

​youtube_channel

​youtube_channel_videos

​youtube_channel_shorts

​youtube_search

​TikTok

​get_tiktok_profile

​get_tiktok_profile_videos

​get_tiktok_transcript

​get_tiktok_video

​get_tiktok_video_comments

​get_tiktok_user_followers

​get_tiktok_user_following

​search_tiktok_users

​LinkedIn

​linkedin_profile

​linkedin_company

​Document Processing

​doc_to_text

​convert_to_pdf

​merge_pdfs

​read_pdf_metadata

​write_pdf_metadata

​extract_document

​extract_pdf

​extract_image

​extract_audio

​extract_video

​trim_video

​AI & Generation

​generate_agent_completion

​generate_ai_image

​Developer Tools

​run_js_code

​run_python_code

​Authentication

​Error Handling

​Credit Usage

​Support

Documentation Index

DumplingAI MCP Server

Features

Installation

Claude Code

Claude Desktop

Cursor

Windsurf

VS Code + Copilot

n8n

Available Tools

Web Scraping & Extraction

`scrape`

`crawl`

`screenshot`

`extract`

Search & Discovery

`search`

`search_news`

`search_maps`

`search_places`

`get_autocomplete`

`get_google_reviews`

`google_locations`

YouTube

`get_youtube_transcript`

`youtube_video`

`youtube_video_comments`

`youtube_channel`

`youtube_channel_videos`

`youtube_channel_shorts`

`youtube_search`

TikTok

`get_tiktok_profile`

`get_tiktok_profile_videos`

`get_tiktok_transcript`

`get_tiktok_video`

`get_tiktok_video_comments`

`get_tiktok_user_followers`

`get_tiktok_user_following`

`search_tiktok_users`

LinkedIn

`linkedin_profile`

`linkedin_company`

Document Processing

`doc_to_text`

`convert_to_pdf`

`merge_pdfs`

`read_pdf_metadata`

`write_pdf_metadata`

`extract_document`

`extract_pdf`

`extract_image`

`extract_audio`

`extract_video`

`trim_video`

AI & Generation

`generate_agent_completion`

`generate_ai_image`

Developer Tools

`run_js_code`

`run_python_code`

Authentication

Error Handling

Credit Usage

Support