How long does this set up mcp web search in cursor tutorial take?

Most developers complete this tutorial in 15 to 30 minutes. You will need a Scavio API key (free tier works) and a working Python or JavaScript environment.

What do I need before starting?

Cursor IDE installed (latest version). A Scavio API key from scavio.dev. Basic familiarity with Cursor MCP settings. A Scavio API key gives you 50 free credits on signup.

Can I run this tutorial with the free tier?

Yes. The free tier includes 50 credits on signup, which is more than enough to complete this tutorial and prototype a working solution.

What frameworks does this work with?

Scavio has a native LangChain package (langchain-scavio), an MCP server, and a plain REST API that works with any HTTP client. This tutorial uses the raw REST API, but you can adapt to your framework of choice.

Set Up MCP Web Search in Cursor (2026)

Cursor's background agent can use MCP servers to access external tools, but it lacks built-in web search for checking documentation, API changes, or package versions. Adding an MCP search server gives the agent live SERP results it can reference while coding. This tutorial shows how to configure the Scavio MCP server in Cursor's settings, verify the connection, and use search from within the background agent. You will have a Cursor setup that can look up documentation, check API endpoints, and verify package compatibility on demand.

Prerequisites

Cursor IDE installed (latest version)
A Scavio API key from scavio.dev
Basic familiarity with Cursor MCP settings

Walkthrough

Step 1: Open Cursor MCP settings

Navigate to Cursor settings to add a new MCP server configuration.

Python

# Cursor MCP configuration file location:
# macOS: ~/Library/Application Support/Cursor/mcp.json
# Linux: ~/.config/Cursor/mcp.json
# Or configure via Cursor Settings > MCP Servers

Step 2: Add the Scavio MCP server

Configure the Scavio MCP endpoint with your API key.

Python

# Add to your Cursor MCP configuration:
# {
#   "mcpServers": {
#     "scavio": {
#       "url": "https://mcp.scavio.dev/mcp",
#       "headers": {
#         "x-api-key": "YOUR_SCAVIO_API_KEY"
#       }
#     }
#   }
# }

Step 3: Verify the connection

Test the MCP server connection by running a search from Cursor's agent.

Python

# In Cursor background agent, ask:
# "Search for the latest Next.js 15 API route documentation"
#
# The agent should use the scavio search tool
# and return results from the web

Step 4: Test the API directly

Verify the search API works before relying on the MCP connection.

Python

import os, requests

API_KEY = os.environ["SCAVIO_API_KEY"]
resp = requests.post("https://api.scavio.dev/api/v1/search",
    headers={"x-api-key": API_KEY},
    json={"platform": "google", "query": "Next.js 15 API routes documentation"})
for r in resp.json().get("organic_results", [])[:3]:
    print(f"{r['title']}: {r.get('link','')}")

Python Example

Python

import os, requests
API_KEY = os.environ["SCAVIO_API_KEY"]
resp = requests.post("https://api.scavio.dev/api/v1/search",
    headers={"x-api-key": API_KEY},
    json={"platform": "google", "query": "Next.js 15 API routes docs"})
for r in resp.json().get("organic_results", [])[:5]:
    print(r["title"], r.get("link",""))

JavaScript Example

JavaScript

const H = {"x-api-key": process.env.SCAVIO_API_KEY, "Content-Type": "application/json"};
async function search(q) {
  const r = await fetch("https://api.scavio.dev/api/v1/search", {
    method: "POST", headers: H,
    body: JSON.stringify({platform: "google", query: q})
  });
  return (await r.json()).organic_results || [];
}
search("Next.js 15 API routes docs").then(rs =>
  rs.slice(0,5).forEach(r => console.log(r.title, r.link))
);

Expected Output

JSON

A Cursor IDE setup with MCP web search that lets the background agent look up documentation, verify APIs, and search the web without leaving the editor.

Prerequisites

Cursor IDE installed (latest version)
A Scavio API key from scavio.dev
Basic familiarity with Cursor MCP settings

Walkthrough

Step 1: Open Cursor MCP settings

Navigate to Cursor settings to add a new MCP server configuration.

Python

# Cursor MCP configuration file location:
# macOS: ~/Library/Application Support/Cursor/mcp.json
# Linux: ~/.config/Cursor/mcp.json
# Or configure via Cursor Settings > MCP Servers

Step 2: Add the Scavio MCP server

Configure the Scavio MCP endpoint with your API key.

Python

# Add to your Cursor MCP configuration:
# {
#   "mcpServers": {
#     "scavio": {
#       "url": "https://mcp.scavio.dev/mcp",
#       "headers": {
#         "x-api-key": "YOUR_SCAVIO_API_KEY"
#       }
#     }
#   }
# }

Step 3: Verify the connection

Test the MCP server connection by running a search from Cursor's agent.

Python

# In Cursor background agent, ask:
# "Search for the latest Next.js 15 API route documentation"
#
# The agent should use the scavio search tool
# and return results from the web

Step 4: Test the API directly

Verify the search API works before relying on the MCP connection.

Python

import os, requests

API_KEY = os.environ["SCAVIO_API_KEY"]
resp = requests.post("https://api.scavio.dev/api/v1/search",
    headers={"x-api-key": API_KEY},
    json={"platform": "google", "query": "Next.js 15 API routes documentation"})
for r in resp.json().get("organic_results", [])[:3]:
    print(f"{r['title']}: {r.get('link','')}")

Python Example

Python

import os, requests
API_KEY = os.environ["SCAVIO_API_KEY"]
resp = requests.post("https://api.scavio.dev/api/v1/search",
    headers={"x-api-key": API_KEY},
    json={"platform": "google", "query": "Next.js 15 API routes docs"})
for r in resp.json().get("organic_results", [])[:5]:
    print(r["title"], r.get("link",""))

JavaScript Example

JavaScript

const H = {"x-api-key": process.env.SCAVIO_API_KEY, "Content-Type": "application/json"};
async function search(q) {
  const r = await fetch("https://api.scavio.dev/api/v1/search", {
    method: "POST", headers: H,
    body: JSON.stringify({platform: "google", query: q})
  });
  return (await r.json()).organic_results || [];
}
search("Next.js 15 API routes docs").then(rs =>
  rs.slice(0,5).forEach(r => console.log(r.title, r.link))
);

Expected Output

JSON

A Cursor IDE setup with MCP web search that lets the background agent look up documentation, verify APIs, and search the web without leaving the editor.

How to Set Up MCP Web Search in Cursor

Prerequisites

Walkthrough

Step 1: Open Cursor MCP settings

Step 2: Add the Scavio MCP server

Step 3: Verify the connection

Step 4: Test the API directly

Python Example

JavaScript Example

Expected Output

Related Tutorials

Frequently Asked Questions

How long does this set up mcp web search in cursor tutorial take?

What do I need before starting?

Can I run this tutorial with the free tier?

What frameworks does this work with?

Related Resources

Best MCP Search Tools for IDE Integration in 2026

Ground Cursor Agent with Live Web Search

MCP Search Gateway for Multi-Agent Systems

Best Search API for Hermes Agent in 2026

Cursor MCP Web Search

Cursor Agent Search Grounding Pipeline

Start Building

How to Set Up MCP Web Search in Cursor

Prerequisites

Walkthrough

Step 1: Open Cursor MCP settings

Step 2: Add the Scavio MCP server

Step 3: Verify the connection

Step 4: Test the API directly

Python Example

JavaScript Example

Expected Output

Related Tutorials

Frequently Asked Questions

How long does this set up mcp web search in cursor tutorial take?

What do I need before starting?

Can I run this tutorial with the free tier?

What frameworks does this work with?

Related Resources

Best MCP Search Tools for IDE Integration in 2026

Ground Cursor Agent with Live Web Search

MCP Search Gateway for Multi-Agent Systems

Best Search API for Hermes Agent in 2026

Cursor MCP Web Search

Cursor Agent Search Grounding Pipeline

Start Building