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

Connect Claude, Codex, Cursor, Windsurf, ChatGPT, and other MCP-compatible clients to DumplingAI. The recommended hosted MCP server is:

https://mcp.dumplingai.com/mcp/v2

/mcp/v2 is the default surface for new users. It uses OAuth, so most modern MCP clients only need the server URL and will handle browser sign-in automatically.

Overview

DumplingAI currently exposes two MCP surfaces:

/mcp/v2: the recommended capability-first surface backed by the Agent API
/mcp: the legacy v1 tool catalog that still uses API keys

Start with /mcp/v2 unless you specifically need the older v1 catalog.

Getting started

Add this server URL to your MCP client:

https://mcp.dumplingai.com/mcp/v2

On first connection, DumplingAI redirects you to your browser to sign in and approve access. The OAuth grant is bound to your current active DumplingAI organization. You do not need to configure an API key for /mcp/v2.

App setup

Claude Code

Run this command:

claude mcp add dumplingai --transport http https://mcp.dumplingai.com/mcp/v2

Then restart Claude Code if needed and complete the browser-based OAuth flow on first use.

Claude Desktop

Add a new remote MCP server in Claude Desktop and use:

https://mcp.dumplingai.com/mcp/v2

Claude Desktop should open the DumplingAI OAuth flow in your browser the first time you connect.

Codex

Run this command:

codex mcp add dumplingai --url https://mcp.dumplingai.com/mcp/v2

Codex will open the OAuth flow in your browser on first use.

Cursor

Add a new MCP server in Cursor and set the URL to:

https://mcp.dumplingai.com/mcp/v2

Use Cursor’s remote or URL-based MCP server option if it asks for a connection type.

Windsurf

Add a remote MCP server with this URL:

https://mcp.dumplingai.com/mcp/v2

Then finish the OAuth flow in your browser when prompted.

VS Code / Copilot

Add DumplingAI to your MCP settings:

{
  "servers": {
    "dumplingai": {
      "type": "http",
      "url": "https://mcp.dumplingai.com/mcp/v2"
    }
  }
}

ChatGPT

Add a connector or MCP server using:

https://mcp.dumplingai.com/mcp/v2

Then complete the DumplingAI OAuth flow when ChatGPT prompts you.

Other MCP clients

Any MCP client that supports hosted HTTP servers and OAuth discovery should work with:

https://mcp.dumplingai.com/mcp/v2

Clients discover the auth flow automatically through DumplingAI’s MCP OAuth metadata.

Authentication

/mcp/v2 uses OAuth. That means:

you add the server URL only
DumplingAI handles sign-in and consent in the browser
you do not send Authorization: Bearer YOUR_API_KEY for /mcp/v2

If your client does not support MCP OAuth yet, use the legacy /mcp endpoint instead.

Available tools

/mcp/v2 exposes these capability-first tools:

Tool	Description
`google_search`	Search the web through DumplingAI’s agent API
`search_news`	Find current headlines and recent news results
`search_places`	Search local businesses and Google Maps-style place results
`get_google_reviews`	Fetch Google business reviews and reputation data
`crawl_site`	Crawl a site and return normalized page results
`screenshot`	Capture a page screenshot with optional wait, viewport, and full-page controls
`extract_web`	Extract schema-shaped JSON from a webpage
`extract_document`	Extract text or structured data from one or more files
`scrape_page`	Fetch and structure page content
`get_youtube_transcript`	Get YouTube transcripts with optional timestamps

Provider notes:

screenshot supports firecrawl, scrapingfish, and phantomjscloud
extract_web and extract_document are DumplingAI-managed and surface provider: "dumplingai"

Example tool calls:

{
  "name": "search_news",
  "arguments": {
    "query": "latest AI news",
    "provider": "serper"
  }
}

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

{
  "name": "extract_document",
  "arguments": {
    "inputMethod": "url",
    "files": ["https://example.com/invoice.pdf"],
    "prompt": "Extract the invoice number and total amount",
    "provider": "dumplingai"
  }
}

{
  "name": "get_youtube_transcript",
  "arguments": {
    "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "includeTimestamps": true,
    "provider": "transcriptapi"
  }
}

Troubleshooting

If sign-in finishes but you land on the normal app instead of returning to your MCP client, disconnect and reconnect the MCP server so the client re-runs registration and OAuth.

`localhost` vs `127.0.0.1`

Some clients register loopback callbacks with 127.0.0.1 and then authorize with localhost. DumplingAI normalizes loopback redirects for supported OAuth flows, but reconnecting the client is the fastest fix if an old registration is stuck.

OAuth is not supported in my MCP client

Use the legacy API-key surface instead:

https://mcp.dumplingai.com/mcp

Legacy `/mcp` fallback

Use the legacy endpoint only if your MCP client does not support OAuth yet or if you specifically need the broader v1 tool catalog. The hosted legacy endpoint is:

https://mcp.dumplingai.com/mcp

Add it with an API key header:

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

Get your API key from app.dumplingai.com.

n8n

Add an AI Agent node to your workflow.
Add an MCP Client Tool node.
Create MCP credentials with:
- 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.

Legacy `/mcp` tool catalog

The rest of this page documents the older /mcp surface backed by /api/v1/*.

Legacy 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

​Documentation Index

​DumplingAI MCP Server

​Overview

​Getting started

​App setup

​Claude Code

​Claude Desktop

​Codex

​Cursor

​Windsurf

​VS Code / Copilot

​ChatGPT

​Other MCP clients

​Authentication

​Available tools

​Troubleshooting

​Browser flow lands on the app instead of consent

​localhost vs 127.0.0.1

​OAuth is not supported in my MCP client

​Legacy /mcp fallback

​n8n

​Legacy /mcp tool catalog

​Legacy 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

Overview

Getting started

App setup

Claude Code

Claude Desktop

Codex

Cursor

Windsurf

VS Code / Copilot

ChatGPT

Other MCP clients

Authentication

Available tools

Troubleshooting

Browser flow lands on the app instead of consent

`localhost` vs `127.0.0.1`

OAuth is not supported in my MCP client

Legacy `/mcp` fallback

n8n

Legacy `/mcp` tool catalog

Legacy 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