Dumpling AI MCP Server
OfficialProvides access to Google search functionality with customizable parameters, including the ability to scrape content from search results
Enables searching Google Maps for locations and businesses with customizable parameters like GPS position and zoom level
Provides capability to execute JavaScript code with optional dependencies in a secure environment
Supported as an optional dependency when running JavaScript code through the run-js-code tool
Supported as a content format option for web scraping and data extraction functionality
Mentioned as an example in knowledge base functionality, allowing storage and retrieval of document-based data
Supported as an optional dependency when running Python code through the run-python-code tool
Supported as an optional dependency when running Python code through the run-python-code tool
Enables execution of Python code with optional dependencies and file output capabilities
Allows extraction of transcripts from YouTube videos with optional timestamps and language preferences
Used for input validation with schemas in the server's error handling system
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Dumpling AI MCP Serverscrape the latest AI news from TechCrunch and format it as markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Dumpling AI MCP Server
A Model Context Protocol (MCP) server implementation that integrates with Dumpling AI for data scraping, content processing, knowledge management, AI agents, and code execution capabilities.
Features
Complete integration with all Dumpling AI API endpoints
Data APIs for YouTube transcripts, search, autocomplete, maps, places, news, and reviews
Web scraping with support for scraping, crawling, screenshots, and structured data extraction
Document conversion tools for text extraction, PDF operations, video processing
Extract data from documents, images, audio, and video
AI capabilities including agent completions, knowledge base management, and image generation
Developer tools for running JavaScript and Python code in a secure environment
Automatic error handling and detailed response formatting
Related MCP server: document-parser
Installation
Installing via Smithery
To install mcp-server-dumplingai for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @Dumpling-AI/mcp-server-dumplingai --client claudeRunning with npx
env DUMPLING_API_KEY=your_api_key npx -y mcp-server-dumplingaiManual Installation
npm install -g mcp-server-dumplingaiRunning on Cursor
Configuring Cursor 🖥️ Note: Requires Cursor version 0.45.6+
To configure Dumpling AI MCP in Cursor:
Open Cursor Settings
Go to Features > MCP Servers
Click "+ Add New MCP Server"
Enter the following:
{
"mcpServers": {
"dumplingai": {
"command": "npx",
"args": ["-y", "mcp-server-dumplingai"],
"env": {
"DUMPLING_API_KEY": "<your-api-key>"
}
}
}
}If you are using Windows and are running into issues, try
cmd /c "set DUMPLING_API_KEY=your-api-key && npx -y mcp-server-dumplingai"
Replace your-api-key with your Dumpling AI API key.
Configuration
Environment Variables
DUMPLING_API_KEY: Your Dumpling AI API key (required)
Available Tools
Data APIs
1. Get YouTube Transcript (get-youtube-transcript)
Extract transcripts from YouTube videos with optional timestamps.
{
"name": "get-youtube-transcript",
"arguments": {
"videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"includeTimestamps": true,
"timestampsToCombine": 3,
"preferredLanguage": "en"
}
}2. Search (search)
Perform Google web searches and optionally scrape content from results.
{
"name": "search",
"arguments": {
"query": "machine learning basics",
"country": "us",
"language": "en",
"dateRange": "pastMonth",
"scrapeResults": true,
"numResultsToScrape": 3,
"scrapeOptions": {
"format": "markdown",
"cleaned": true
}
}
}3. Get Autocomplete (get-autocomplete)
Get Google search autocomplete suggestions for a query.
{
"name": "get-autocomplete",
"arguments": {
"query": "how to learn",
"country": "us",
"language": "en",
"location": "New York"
}
}4. Search Maps (search-maps)
Search Google Maps for locations and businesses.
{
"name": "search-maps",
"arguments": {
"query": "coffee shops",
"gpsPositionZoom": "37.7749,-122.4194,14z",
"language": "en",
"page": 1
}
}5. Search Places (search-places)
Search for places with more detailed information.
{
"name": "search-places",
"arguments": {
"query": "hotels in paris",
"country": "fr",
"language": "en",
"page": 1
}
}6. Search News (search-news)
Search for news articles with customizable parameters.
{
"name": "search-news",
"arguments": {
"query": "climate change",
"country": "us",
"language": "en",
"dateRange": "pastWeek"
}
}7. Get Google Reviews (get-google-reviews)
Retrieve Google reviews for businesses or places.
{
"name": "get-google-reviews",
"arguments": {
"businessName": "Eiffel Tower",
"location": "Paris, France",
"limit": 10,
"sortBy": "relevance"
}
}Web Scraping
8. Scrape (scrape)
Extract content from a web page with formatting options.
{
"name": "scrape",
"arguments": {
"url": "https://example.com",
"format": "markdown",
"cleaned": true,
"renderJs": true
}
}9. Crawl (crawl)
Recursively crawl websites and extract content with customizable parameters.
{
"name": "crawl",
"arguments": {
"baseUrl": "https://example.com",
"maxPages": 10,
"crawlBeyondBaseUrl": false,
"depth": 2,
"scrapeOptions": {
"format": "markdown",
"cleaned": true,
"renderJs": true
}
}
}10. Screenshot (screenshot)
Capture screenshots of web pages with customizable viewport and format options.
{
"name": "screenshot",
"arguments": {
"url": "https://example.com",
"width": 1280,
"height": 800,
"fullPage": true,
"format": "png",
"waitFor": 1000
}
}11. Extract (extract)
Extract structured data from web pages using AI-powered instructions.
{
"name": "extract",
"arguments": {
"url": "https://example.com/products",
"instructions": "Extract all product names, prices, and descriptions from this page",
"schema": {
"products": [
{
"name": "string",
"price": "number",
"description": "string"
}
]
},
"renderJs": true
}
}Document Conversion
12. Doc to Text (doc-to-text)
Convert documents to plaintext with optional OCR.
{
"name": "doc-to-text",
"arguments": {
"url": "https://example.com/document.pdf",
"options": {
"ocr": true,
"language": "en"
}
}
}13. Convert to PDF (convert-to-pdf)
Convert various file formats to PDF.
{
"name": "convert-to-pdf",
"arguments": {
"url": "https://example.com/document.docx",
"format": "docx",
"options": {
"quality": 90,
"pageSize": "A4",
"margin": 10
}
}
}14. Merge PDFs (merge-pdfs)
Combine multiple PDFs into a single document.
{
"name": "merge-pdfs",
"arguments": {
"urls": ["https://example.com/doc1.pdf", "https://example.com/doc2.pdf"],
"options": {
"addPageNumbers": true,
"addTableOfContents": true
}
}
}15. Trim Video (trim-video)
Extract a specific clip from a video.
{
"name": "trim-video",
"arguments": {
"url": "https://example.com/video.mp4",
"startTime": 30,
"endTime": 60,
"output": "mp4",
"options": {
"quality": 720,
"fps": 30
}
}
}16. Extract Document (extract-document)
Extract specific content from documents in various formats.
{
"name": "extract-document",
"arguments": {
"url": "https://example.com/document.pdf",
"format": "structured",
"options": {
"ocr": true,
"language": "en",
"includeMetadata": true
}
}
}17. Extract Image (extract-image)
Extract text and information from images.
{
"name": "extract-image",
"arguments": {
"url": "https://example.com/image.jpg",
"extractionType": "text",
"options": {
"language": "en",
"detectOrientation": true
}
}
}18. Extract Audio (extract-audio)
Transcribe and extract information from audio files.
{
"name": "extract-audio",
"arguments": {
"url": "https://example.com/audio.mp3",
"language": "en",
"options": {
"model": "enhanced",
"speakerDiarization": true,
"wordTimestamps": true
}
}
}19. Extract Video (extract-video)
Extract content from videos including transcripts, scenes, and objects.
{
"name": "extract-video",
"arguments": {
"url": "https://example.com/video.mp4",
"extractionType": "transcript",
"options": {
"language": "en",
"speakerDiarization": true
}
}
}20. Read PDF Metadata (read-pdf-metadata)
Extract metadata from PDF files.
{
"name": "read-pdf-metadata",
"arguments": {
"url": "https://example.com/document.pdf",
"includeExtended": true
}
}21. Write PDF Metadata (write-pdf-metadata)
Update metadata in PDF files.
{
"name": "write-pdf-metadata",
"arguments": {
"url": "https://example.com/document.pdf",
"metadata": {
"title": "New Title",
"author": "John Doe",
"keywords": ["keyword1", "keyword2"]
}
}
}AI
22. Generate Agent Completion (generate-agent-completion)
Get AI agent completions with optional tool definitions.
{
"name": "generate-agent-completion",
"arguments": {
"prompt": "How can I improve my website's SEO?",
"model": "gpt-4",
"temperature": 0.7,
"maxTokens": 500,
"context": ["The website is an e-commerce store selling handmade crafts."]
}
}23. Search Knowledge Base (search-knowledge-base)
Search a knowledge base for relevant information.
{
"name": "search-knowledge-base",
"arguments": {
"kbId": "kb_12345",
"query": "How to optimize database performance",
"limit": 5,
"similarityThreshold": 0.7
}
}24. Add to Knowledge Base (add-to-knowledge-base)
Add entries to a knowledge base.
{
"name": "add-to-knowledge-base",
"arguments": {
"kbId": "kb_12345",
"entries": [
{
"text": "MongoDB is a document-based NoSQL database.",
"metadata": {
"source": "MongoDB documentation",
"category": "databases"
}
}
],
"upsert": true
}
}25. Generate AI Image (generate-ai-image)
Generate images using AI models.
{
"name": "generate-ai-image",
"arguments": {
"prompt": "A futuristic city with flying cars and neon lights",
"width": 1024,
"height": 1024,
"numImages": 1,
"quality": "hd",
"style": "photorealistic"
}
}26. Generate Image (generate-image)
Generate images using various AI providers.
{
"name": "generate-image",
"arguments": {
"prompt": "A golden retriever in a meadow of wildflowers",
"provider": "dalle",
"width": 1024,
"height": 1024,
"numImages": 1
}
}Developer Tools
27. Run JavaScript Code (run-js-code)
Execute JavaScript code with optional dependencies.
{
"name": "run-js-code",
"arguments": {
"code": "const result = [1, 2, 3, 4].reduce((sum, num) => sum + num, 0); console.log(`Sum: ${result}`); return result;",
"dependencies": {
"lodash": "^4.17.21"
},
"timeout": 5000
}
}28. Run Python Code (run-python-code)
Execute Python code with optional dependencies.
{
"name": "run-python-code",
"arguments": {
"code": "import numpy as np\narr = np.array([1, 2, 3, 4, 5])\nmean = np.mean(arr)\nprint(f'Mean: {mean}')\nreturn mean",
"dependencies": ["numpy", "pandas"],
"timeout": 10000,
"saveOutputFiles": true
}
}Error Handling
The server provides robust error handling:
Detailed error messages with HTTP status codes
API key validation
Input validation using Zod schemas
Network error handling with descriptive messages
Example error response:
{
"content": [
{
"type": "text",
"text": "Error: Failed to fetch YouTube transcript: 404 Not Found"
}
],
"isError": true
}Development
# Install dependencies
npm install
# Build
npm run build
License
MIT License - see LICENSE file for details
Available Tools
27 toolsadd-to-knowledge-baseC
Add new text resources to a knowledge base.
Inputs: knowledgeBaseId (required), name (required), content (required).
convert-to-pdfC
Convert various file formats to PDF.
Inputs: inputMethod (required), file (required).
crawlC
Recursively crawl websites and extract content.
Inputs: url (required), limit, depth, format.
doc-to-textC
Convert various document formats to plain text.
Inputs: inputMethod (required), file (required), pages.
extractC
Extract structured data from web pages using AI-powered instructions.
Inputs: url (required), schema (required).
extract-audioC
Extract structured data from audio files based on a prompt.
Inputs: inputMethod (required), audio (required), prompt (required), jsonMode.
extract-documentC
Extract structured data from documents based on a prompt.
Inputs: inputMethod (required), files (required), prompt (required), jsonMode.
extract-imageC
Extract structured data from images based on a prompt.
Inputs: inputMethod (required), images (required), prompt (required), jsonMode.
extract-videoC
Extract structured data from videos based on a prompt.
Inputs: inputMethod (required), video (required), prompt (required), jsonMode.
generate-agent-completionC
Generate AI text completions with customizable parameters.
Inputs: messages (required), agentId (required), parseJson, threadId.
generate-ai-imageC
Generate AI images from text prompts.
Inputs: model (required), input (required).
get-autocompleteC
Retrieve Google autocomplete suggestions for a query.
Inputs: query (required), location, country, language.
get-google-reviewsC
Retrieve Google reviews for businesses or places.
Inputs: keyword, cid, placeId, reviews, +3 more.
get-youtube-transcriptC
Extract transcripts from YouTube videos with optional parameters for timestamps and language preferences.
Inputs: videoUrl (required), includeTimestamps, timestampsToCombine, preferredLanguage.
merge-pdfsC
Combine multiple PDF files into a single document.
Inputs: inputMethod (required), files (required), metadata, pdfa, +2 more.
read-pdf-metadataC
Extract metadata from PDF files.
Inputs: inputMethod (required), files (required), requestSource.
run-js-codeC
Execute JavaScript code in a sandbox.
Inputs: code (required), commands, parseJson, timeout, +1 more.
run-python-codeC
Execute Python code in a sandbox.
Inputs: code (required), commands, parseJson, timeout, +2 more.
scrapeC
Extract and parse content from any web page.
Inputs: url (required), format, cleaned, renderJs.
screenshotC
Capture screenshots of web pages with customizable settings.
Inputs: url (required), width, height, deviceScaleFactor, +8 more.
searchC
Perform Google web searches with customizable parameters.
Inputs: query (required), country, location, language, +5 more.
search-knowledge-baseC
Search a knowledge base for relevant information.
Inputs: knowledgeBaseId (required), query (required), resultCount.
search-mapsC
Search Google Maps for locations and businesses.
Inputs: query (required), gpsPositionZoom, placeId, cid, +2 more.
search-newsC
Search for news articles across multiple sources.
Inputs: query (required), country, location, language, +2 more.
search-placesC
Search for places with detailed business information.
Inputs: query (required), country, location, language, +1 more.
trim-videoC
Trim videos to a specific duration.
Inputs: videoUrl (required), startTimestamp (required), endTimestamp (required).
write-pdf-metadataC
Write metadata to PDF files.
Inputs: inputMethod (required), files (required), metadata (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
TDQS
Scored across 27 tools
Most tools have distinct purposes, but there is some overlap that could cause confusion. For example, 'extract' and 'scrape' both handle web data extraction, and 'search-places' and 'search-maps' both involve location searches, though their descriptions differ slightly. The AI-powered extraction tools (extract-audio, extract-document, etc.) are well-differentiated by media type.
Tool names follow a consistent verb-noun pattern with hyphens, such as 'add-to-knowledge-base' and 'convert-to-pdf'. However, there are minor deviations like 'run-js-code' and 'run-python-code' using 'run' instead of more specific verbs, and 'get-autocomplete' could be clearer. Overall, the naming is predictable and readable.
With 27 tools, the count is high and feels heavy for a single server, suggesting potential scope creep. While the tools cover diverse data processing tasks, a more focused set might improve usability. This many tools can overwhelm agents and increase the risk of misselection.
The server provides comprehensive coverage for data extraction, conversion, and search across various media types and sources. Minor gaps exist, such as no explicit tool for deleting or managing knowledge base entries, but core workflows like PDF handling (convert, merge, read/write metadata) and web interactions (crawl, search, screenshot) are well-covered.
Maintenance
Related MCP Connectors
Direct access to 60+ scraping and search tools. Extract structured data from Google (Search, Maps, Trends), Amazon, Airbnb, Social Media, and any web page directly into your AI agent.
Web tools for AI agents: URL to clean Markdown, site crawl, screenshots, PDF/Office to text, OCR.
Web scraping, search, crawling, structured extraction and research for AI agents.
PDF, image, video, OCR, screenshot, SQL, QR and text tools for agents. No API key, no signup.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI models to search the web using DuckDuckGo, scrape webpage content in markdown format, and browse/read local files for code analysis and debugging.12 npm1MIT
- AlicenseNot gradedqualityNot gradedmaintenanceProvides AI agents with comprehensive document parsing capabilities including PDF text extraction, OCR, HTML-to-markdown conversion, table extraction, and summarization, optimized for agent workflows.57 npmMIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to perform anti-bot web scraping, dynamic SPA rendering, YouTube transcript extraction, and deep OSINT/GEOINT intelligence gathering through 23 integrated tools.-
- FlicenseNot gradedqualityAmaintenanceEnables language models to perform AI-powered web scraping, structured extraction, search, crawling, schema generation, and scheduled monitoring through an integrated web-scraping API.-