MCP Server Builder
anthropics/skills
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
Run DataForSEO API tasks via the CLI in a shell (docs index, docs search, request).
Install Dataforseo MCP Server
$ npx skills add dataforseo/mcp-server-typescript --skill dataforseo-mcp-server -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install dataforseo/mcp-server-typescript dataforseo-mcp-server --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
Claude Code skills documentation · loads skills from .claude/skills/
Install the "dataforseo-mcp-server" agent skill from https://github.com/dataforseo/mcp-server-typescript/tree/master into .claude/skills/dataforseo-mcp-server/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo-mcp-server", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dataforseo/mcp-server-typescript --skill dataforseo-mcp-server -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install dataforseo/mcp-server-typescript dataforseo-mcp-server --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "dataforseo-mcp-server" agent skill from https://github.com/dataforseo/mcp-server-typescript/tree/master into .agents/skills/dataforseo-mcp-server/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo-mcp-server", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dataforseo/mcp-server-typescript --skill dataforseo-mcp-server -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install dataforseo/mcp-server-typescript dataforseo-mcp-server --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "dataforseo-mcp-server" agent skill from https://github.com/dataforseo/mcp-server-typescript/tree/master into .cursor/skills/dataforseo-mcp-server/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo-mcp-server", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dataforseo/mcp-server-typescript --skill dataforseo-mcp-server -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install dataforseo/mcp-server-typescript dataforseo-mcp-server --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "dataforseo-mcp-server" agent skill from https://github.com/dataforseo/mcp-server-typescript/tree/master into .gemini/skills/dataforseo-mcp-server/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo-mcp-server", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install dataforseo/mcp-server-typescript dataforseo-mcp-serverInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add dataforseo/mcp-server-typescript --skill dataforseo-mcp-server -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "dataforseo-mcp-server" agent skill from https://github.com/dataforseo/mcp-server-typescript/tree/master into .github/skills/dataforseo-mcp-server/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo-mcp-server", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dataforseo/mcp-server-typescript --skill dataforseo-mcp-server -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install dataforseo/mcp-server-typescript dataforseo-mcp-server --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "dataforseo-mcp-server" agent skill from https://github.com/dataforseo/mcp-server-typescript/tree/master into .opencode/skills/dataforseo-mcp-server/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dataforseo-mcp-server", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
dataforseo-mcp-server- GitHub stars
- 251
- Used in
- 1 other repo
- Token cost
- ~2.4k tokens
- SKILL.md length
- 758 words
- Files
- 84 (incl. scripts)
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Run DataForSEO API tasks via the CLI in a shell (docs index, docs search, request).
- Works in 3 steps: Invoke via shell — use the terminal… → Read the output — successful results are… → Auth for CLI — set DATAFORSEO_LOGIN and…
- The agent should execute terminal commands with npx dataforseo-mcp-server
- SKILL.md covers How AI agents interact with…, Authentication, Quick reference and Agent workflow (shell), plus 4 more sections
- Runs TypeScript and JavaScript scripts from its folder; calls npx and npm; reaches docs.dataforseo.com and data.dataforseo.com; needs DATAFORSEO_PASSWORD
What it does
Dataforseo MCP Server is an agent skill from dataforseo/mcp-server-typescript. Run DataForSEO API tasks via the CLI in a shell (docs index, docs search, request). Use when the agent should execute terminal commands with npx dataforseo-mcp-server.
Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 87 other files, including scripts (for example `.github/dependabot.yml`, `.github/workflows/docker.yaml` and `.github/workflows/npm.yaml`).
It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol and TypeScript. The repository describes itself as: DataForSEO API modelcontextprotocol server. The licence is Apache-2.0.
When your agent uses it
- The agent should execute terminal commands with npx dataforseo-mcp-server
- Tasks that involve MCP servers
Example prompts
- “/dataforseo-mcp-server”
Requirements
- Node.js
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Invoke via shell — use the terminal (Shell tool) to run npx dataforseo-mcp-server … commands.
- Read the output — successful results are printed to stdout (JSON or documentation text). Errors go to stderr and exit code is non-zero.
- Auth for CLI — set DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD in the shell environment (fallback / CLI path; see Authentication below).
What it can do on your machine
Read from SKILL.md and the folder at commit 1fc6d19. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/ (TypeScript and JavaScript, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
npxnpm
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
docs.dataforseo.comdata.dataforseo.comapi.dataforseo.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
DATAFORSEO_PASSWORD
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Dataforseo MCP Server loads about 2.4k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 758 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from dataforseo/mcp-server-typescript at commit 1fc6d19, republished under its Apache-2.0 licence (© dataforseo). 758 words, ~2,399 tokens.
Download SKILL.mdSave it as
.claude/skills/dataforseo-mcp-server/SKILL.md (or your agent's skills folder). This skill also uses 83 other files; get the full folder from GitHub.- name
- dataforseo-mcp-server
- description
- Run DataForSEO API tasks via the CLI in a shell (docs index, docs search, request). Use when the agent should execute terminal commands with npx dataforseo-mcp-server.
DataForSEO MCP Server — LLM Agent Guide
Run shell commands and read stdout/stderr. Always invoke the tool through the terminal — never substitute another integration path.
How AI agents interact with this tool
- Invoke via shell — use the terminal (Shell tool) to run
npx dataforseo-mcp-server …commands. - Read the output — successful results are printed to stdout (JSON or documentation text). Errors go to stderr and exit code is non-zero.
- Auth for CLI — set
DATAFORSEO_LOGINandDATAFORSEO_PASSWORDin the shell environment (fallback / CLI path; see Authentication below).
Binary name: npx dataforseo-mcp-server (or npx . from this repo root after npm install + npm run build).
Working directory: any directory where credentials are available in the environment (for CLI).
Authentication
| Mode | Preferred auth | Fallback |
|---|---|---|
MCP stdio (default when no CLI command; or npx dataforseo-mcp-server with no args) | Env credentials (HTTP Basic) | — |
HTTP MCP (--mode http) | OAuth 2.0 Bearer via authorization server https://data.dataforseo.com (discovery at /.well-known/oauth-protected-resource) | DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD in env |
CLI (docs / request / --cli) | Env credentials (HTTP Basic) | — |
Override the authorization server with AUTH_SERVER_URL if needed.
Quick reference
| Task | Shell command |
|---|---|
| Docs index | npx dataforseo-mcp-server docs index [--section "SERP API"] |
| List sections | npx dataforseo-mcp-server docs index --list-sections |
| Endpoint docs | npx dataforseo-mcp-server docs search <url-or-path> |
| Endpoint docs (with code examples) | npx dataforseo-mcp-server docs search <url-or-path> --need-code-example |
| GET request | npx dataforseo-mcp-server request -X GET -p /v3/... |
| POST request | npx dataforseo-mcp-server request -X POST -p <path> --param key=value ... |
| POST request (JSON) | npx dataforseo-mcp-server request -X POST -p <path> -d '<json-array>' |
By default, API paths use the .ai suffix (e.g. /v3/serp/google/organic/live/regular.ai). Pass --no-ai-mode to use the standard path.
CLI credentials (fallback / shell): set DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD as environment variables. Get keys at https://app.dataforseo.com/api-access
export DATAFORSEO_LOGIN=your_api_login
export DATAFORSEO_PASSWORD=your_api_passwordWindows PowerShell: $env:DATAFORSEO_LOGIN="..." / $env:DATAFORSEO_PASSWORD="...". CMD: set DATAFORSEO_LOGIN=...
DATAFORSEO_USERNAME is also accepted as an alias for DATAFORSEO_LOGIN. For HTTP MCP, prefer OAuth; env credentials are only a fallback when no Authorization header is present.
Agent workflow (shell)
Run these steps as separate shell commands:
npx dataforseo-mcp-server docs index --section "<API>"— find endpoint path.npx dataforseo-mcp-server docs search <path>— read method, parameters, example body.npx dataforseo-mcp-server request -X <METHOD> -p <path> --param key=value ...(or-d '<json-array>') — call API.
Parse the printed output to decide the next step.
POST body
POST endpoints accept a JSON array of task objects: [{ ... }].
Preferred: pass fields with repeatable --param key=value (merged into the first task object). Use exact API field names from endpoint docs (e.g. keyword, language_code, location_code).
--param values override the same fields in -d JSON when both are used.
Array values (PowerShell strips " inside [...], so prefer these forms):
# single-item array
--param keywords=[phone]
# multiple items (pipe-separated)
--param keywords=[phone|tablet|laptop]
# or repeat the same key
--param keywords=phone --param keywords=tablet
# order_by with comma inside the value
--param order_by=[keyword_info.search_volume,desc]Valid JSON in --param still works when your shell preserves quotes (bash: 'keywords=["phone"]').
Example: Live SERP (/v3/serp/google/organic/live/regular)
npx dataforseo-mcp-server request -X POST -p /v3/serp/google/organic/live/regular \
--param keyword=dataforseo --param language_code=en --param location_code=2840JSON form:
npx dataforseo-mcp-server request -X POST -p /v3/serp/google/organic/live/regular -d '[{\"keyword\":\"dataforseo\",\"location_code\":2840,\"language_code\":\"en\"}]'Installation (once per environment)
cd /path/to/mcp-server-typescript
npm install
npm run build
export DATAFORSEO_LOGIN=your_api_login
export DATAFORSEO_PASSWORD=your_api_password
npx dataforseo-mcp-server --helpFrom a project with CLI as a dependency:
cd /path/to/your-project
npm install
export DATAFORSEO_LOGIN=your_api_login
export DATAFORSEO_PASSWORD=your_api_password
npx dataforseo-mcp-server docs index --list-sectionsDev without build (CLI repo only): npm run dev -- docs index
Show full SKILL.md (296 more words)Show less
Commands reference
docs index
npx dataforseo-mcp-server docs index
npx dataforseo-mcp-server docs index --section "SERP API"
npx dataforseo-mcp-server docs index --list-sections
npx dataforseo-mcp-server docs index --cache-dir D:\my-docs-cacheSections: SERP API, AI Optimization API, Keywords Data API, Domain Analytics API, DataForSEO Labs API, OnPage API, Backlinks API, Content Analysis API, Merchant API, App Data API, Business Data API, Databases, Appendix.
docs search
npx dataforseo-mcp-server docs search serp/google/organic/live/regular
npx dataforseo-mcp-server docs search https://docs.dataforseo.com/v3/on_page/instant_pages
npx dataforseo-mcp-server docs search backlinks/referring_networks/live --need-code-example
npx dataforseo-mcp-server docs search serp/google/organic/live/regular --cache-dir D:\my-docs-cacheAccepts a documentation URL or a path relative to https://docs.dataforseo.com/v3/. The .md suffix is optional. Pass --need-code-example to include full code examples.
Documentation cache
docs index and docs search cache fetched documentation for 24 hours.
| Override | Example |
|---|---|
| Default (Windows) | %LOCALAPPDATA%\dataforseo-mcp-server\docs-cache |
| CLI flag | --cache-dir D:\my-cache |
| MCP startup arg | --docs-cache-dir D:\my-cache in server args |
If not overridden, the platform default directory is used.
request
| Option | Description |
|---|---|
-X, --method | GET, POST, PUT, DELETE (required) |
-p, --path | /v3/serp/google/organic/live/regular |
-u, --url | Full URL (alternative to -p) |
-d, --data | JSON body (POST/PUT) |
--param <key=value> | Request field (repeatable; merged into first task) |
--no-ai-mode | Use standard API path without .ai (default: .ai is on) |
Response output is the API response body (parsed JSON when possible). Optional field filtering via --configuration field-config.json / FIELD_CONFIG_PATH (keys = endpoint paths; see field-config.example.json).
DataForSEO API basics
- API base:
https://api.dataforseo.com - Docs base:
https://docs.dataforseo.com/v3 - Auth: OAuth Bearer preferred on HTTP MCP; HTTP Basic via
DATAFORSEO_LOGIN/DATAFORSEO_PASSWORDas fallback (and for CLI/stdio) - POST body: JSON from endpoint documentation
- Response:
status_code20000= OK; each task hasid,status_code,result - Standard vs Live: Standard = POST task then GET by id; Live = one POST returns results
- Errors:
npx dataforseo-mcp-server docs search appendix/errors
| Product | Use case |
|---|---|
| SERP API | Search results (Google, Bing, etc.) |
| Keywords Data API | Search volume, suggestions |
| DataForSEO Labs API | Keyword research, competitors |
| Backlinks API | Backlink profiles |
| OnPage API | Site crawl, audit, instant pages |
| Domain Analytics API | Domain metrics, WHOIS |
| Content Analysis API | Brand mentions |
| Merchant API | Google Shopping data |
| Business Data API | GBP, reviews |
| App Data API | App Store / Play Store |
| AI Optimization API | LLM mention tracking |
© dataforseo, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 83 other files (scripts) in the repository root of dataforseo/mcp-server-typescript.
- SKILL.md
- .dockerignore
- .github/dependabot.yml
- .github/workflows/docker.yaml
- .github/workflows/npm.yaml
- .gitignore
- .vscode/launch.json
- .vscode/settings.json
- Dockerfile
- LICENSE
- README.md
- field-config.example.json
- package-lock.json
- package.json
- scripts/debug-cli.ts
- scripts/generate-worker-version.cjs
- src
- … and 67 more
Open the folder on GitHubat commit 1fc6d19
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in dataforseo/mcp-server-typescript, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Dataforseo MCP Server next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Dataforseo MCP Server this skilldataforseo/mcp-server-typescript | 251 | 1 repos | ~2.4k | Automated safety check: Pass | Apache-2.0 | |
| MCP Server Builderanthropics/skills | 180k | 64 repos | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| MCP Server BuildershareAI-lab/learn-claude-code | 78k | 5 repos | ~1.2k | Automated safety check: Pass | MIT | |
| MCP Server Builder with mcp-usemcp-use/mcp-use | 11k | — | ~923 | Automated safety check: Pass | Apache-2.0 | |
| Source Driven Developmentshashankswe2020-ux/whoop-mcp | 165 | 4 repos | ~2k | Automated safety check: Pass | MIT | |
| OpenpetsOpenPetsHQ/openpets | 1.3k | — | ~2.1k | Automated safety check: Pass | MIT |
Similar skills
- Official
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
MCP Server Builder with mcp-use
mcp-use/mcp-use
Builds, modifies, debugs, migrates and verifies TypeScript MCP servers and MCP Apps with the mcp-use framework, treating the installed package's types as the source of truth.
Source Driven Development
shashankswe2020-ux/whoop-mcp
Grounds every implementation decision in official documentation.
Openpets
OpenPetsHQ/openpets
A skill your agent uses whenever the user wants to build, extend, debug, test, validate, locally load, package, or publish an OpenPets plugin; work with the OpenPets Plugin SDK v3, plugin manifest…
Chatgpt App Builder
alpic-ai/skybridge
Guide developers through creating and updating ChatGPT plugins.
Related
Works with
Categories
Questions about Dataforseo MCP Server
What does Dataforseo MCP Server do?
Run DataForSEO API tasks via the CLI in a shell (docs index, docs search, request). Dataforseo MCP Server is an agent skill from dataforseo/mcp-server-typescript. Run DataForSEO API tasks via the CLI in a shell (docs index, docs search, request).
When should I use Dataforseo MCP Server?
Dataforseo MCP Server fits situations like: the agent should execute terminal commands with npx dataforseo-mcp-server; tasks that involve MCP servers.
How do I install Dataforseo MCP Server in Claude Code?
Run `npx skills add dataforseo/mcp-server-typescript --skill dataforseo-mcp-server -a claude-code`. Or copy the skill folder (the dataforseo/mcp-server-typescript repository) into .claude/skills/dataforseo-mcp-server in your project. Claude Code loads it when a task matches its description.
How do I install Dataforseo MCP Server in Codex?
Run `npx skills add dataforseo/mcp-server-typescript --skill dataforseo-mcp-server -a codex`. Or copy the skill folder (the dataforseo/mcp-server-typescript repository) into .agents/skills/dataforseo-mcp-server in your project. Codex loads it when a task matches its description.
Can I use Dataforseo MCP Server in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dataforseo/mcp-server-typescript --skill dataforseo-mcp-server -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dataforseo-mcp-server, .gemini/skills/dataforseo-mcp-server, .github/skills/dataforseo-mcp-server and .opencode/skills/dataforseo-mcp-server in your project.
What does Dataforseo MCP Server need to run?
Going by SKILL.md and its folder, Dataforseo MCP Server needs TypeScript and JavaScript for the scripts in its folder, the command-line tools its instructions call (npx and npm) and credentials named DATAFORSEO_PASSWORD. Our summary lists: Node.js.
Does Dataforseo MCP Server access the network?
SKILL.md names 3 domains. In commands or code: docs.dataforseo.com, data.dataforseo.com and api.dataforseo.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.
Is Dataforseo MCP Server safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Dataforseo MCP Server use?
Dataforseo MCP Server is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Dataforseo MCP Server use?
About 2.4k tokens (SKILL.md is roughly 9.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Dataforseo MCP Server?
Skills that share tags, products or a category with Dataforseo MCP Server: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Server Builder with mcp-use (mcp-use/mcp-use, 11k stars) and Source Driven Development (shashankswe2020-ux/whoop-mcp, 165 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Dataforseo MCP Server?
dataforseo (a GitHub organization) maintains it in dataforseo/mcp-server-typescript, which has 251 GitHub stars. The repository was last updated on October 2, 2026.
Source: dataforseo/mcp-server-typescript on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.