Uses the ScrapeGraphAI API to convert web pages to markdown, extract structured data and run AI web searches.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add scrapegraph --env SGAI_API_KEY='<SGAI_API_KEY>' --env SCRAPEGRAPH_API_KEY='<SCRAPEGRAPH_API_KEY>' -- uvx scrapegraph-mcp~/.codex/config.toml
[mcp_servers.scrapegraph]
command = "uvx"
args = ["scrapegraph-mcp"]
env = { SGAI_API_KEY = "<SGAI_API_KEY>", SCRAPEGRAPH_API_KEY = "<SCRAPEGRAPH_API_KEY>" }
# codex mcp add scrapegraph --env SGAI_API_KEY='<SGAI_API_KEY>' --env SCRAPEGRAPH_API_KEY='<SCRAPEGRAPH_API_KEY>' -- uvx scrapegraph-mcp~/.cursor/mcp.json
{
"mcpServers": {
"scrapegraph": {
"command": "uvx",
"args": [
"scrapegraph-mcp"
],
"env": {
"SGAI_API_KEY": "<SGAI_API_KEY>",
"SCRAPEGRAPH_API_KEY": "<SCRAPEGRAPH_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"scrapegraph": {
"type": "stdio",
"command": "uvx",
"args": [
"scrapegraph-mcp"
],
"env": {
"SGAI_API_KEY": "<SGAI_API_KEY>",
"SCRAPEGRAPH_API_KEY": "<SCRAPEGRAPH_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"scrapegraph": {
"command": "uvx",
"args": [
"scrapegraph-mcp"
],
"env": {
"SGAI_API_KEY": "<SGAI_API_KEY>",
"SCRAPEGRAPH_API_KEY": "<SCRAPEGRAPH_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"scrapegraph": {
"command": "uvx",
"args": [
"scrapegraph-mcp"
],
"env": {
"SGAI_API_KEY": "<SGAI_API_KEY>",
"SCRAPEGRAPH_API_KEY": "<SCRAPEGRAPH_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"scrapegraph": {
"command": "uvx",
"args": [
"scrapegraph-mcp"
],
"env": {
"SGAI_API_KEY": "<SGAI_API_KEY>",
"SCRAPEGRAPH_API_KEY": "<SCRAPEGRAPH_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http scrapegraph https://server.smithery.ai/@ScrapeGraphAI/scrapegraph-mcp/mcp --header 'Authorization: Bearer <SMITHERY_API_KEY>'~/.codex/config.toml
[mcp_servers.scrapegraph]
url = "https://server.smithery.ai/@ScrapeGraphAI/scrapegraph-mcp/mcp"
bearer_token_env_var = "SCRAPEGRAPH_SMITHERY_API_KEY"
# codex mcp add scrapegraph --url https://server.smithery.ai/@ScrapeGraphAI/scrapegraph-mcp/mcp --bearer-token-env-var SCRAPEGRAPH_SMITHERY_API_KEY
# export SCRAPEGRAPH_SMITHERY_API_KEY=<SMITHERY_API_KEY>~/.cursor/mcp.json
{
"mcpServers": {
"scrapegraph": {
"url": "https://server.smithery.ai/@ScrapeGraphAI/scrapegraph-mcp/mcp",
"headers": {
"Authorization": "Bearer <SMITHERY_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"scrapegraph": {
"type": "http",
"url": "https://server.smithery.ai/@ScrapeGraphAI/scrapegraph-mcp/mcp",
"headers": {
"Authorization": "Bearer <SMITHERY_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"scrapegraph": {
"httpUrl": "https://server.smithery.ai/@ScrapeGraphAI/scrapegraph-mcp/mcp",
"headers": {
"Authorization": "Bearer <SMITHERY_API_KEY>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"scrapegraph": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://server.smithery.ai/@ScrapeGraphAI/scrapegraph-mcp/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer <SMITHERY_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"scrapegraph": {
"url": "https://server.smithery.ai/@ScrapeGraphAI/scrapegraph-mcp/mcp",
"headers": {
"Authorization": "Bearer <SMITHERY_API_KEY>"
}
}
}
}Environment variables
SGAI_API_KEYSCRAPEGRAPH_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.