Openwebninja MCP server

OpenWeb Ninja MCP Server

Official Model Context Protocol server for OpenWeb Ninja APIs. Gives any MCP-compatible AI agent (Claude, Cursor, Cline, and others) real-time access to web search, local business data, jobs, e-commerce, real estate, finance, news, and more, through a single connection.

One tool per API product (41 tools), each exposing that API's operations, plus a subscribe tool for adding an API's free tier on demand — 42 tools in total. Schemas are generated directly from OpenWeb Ninja's OpenAPI specs, so the server always matches the live APIs.

Setup

You need an OpenWeb Ninja API key. Get one at openwebninja.com.

The server runs via npx — there's nothing to install globally. Pick your client below; npx fetches @openwebninja/mcp-server on demand.

Claude Desktop

Add to claudedesktopconfig.json (Settings -> Developer -> Edit Config):

{
  "mcpServers": {
    "openwebninja": {
      "command": "npx",
      "args": ["-y", "@openwebninja/mcp-server"],
      "env": { "OPENWEBNINJA_API_KEY": "your-api-key" }
    }
  }
}

Claude Code

claude mcp add openwebninja -e OPENWEBNINJA_API_KEY=your-api-key -- npx -y @openwebninja/mcp-server

Cursor / Cline / Continue / Windsurf

Use the same command / args / env shape in the client's MCP config (mcp.json or equivalent).

From source (local development)

git clone <repo> && cd openwebninja-mcp
npm install
npm run build

Then point your MCP client at the built entry:

{
  "mcpServers": {
    "openwebninja": {
      "command": "node",
      "args": ["/absolute/path/to/openwebninja-mcp/dist/index.js"],
      "env": { "OPENWEBNINJA_API_KEY": "your-api-key" }
    }
  }
}

How the tools work

Each tool maps to one OpenWeb Ninja API and takes two inputs:

• operation: which endpoint to call (e.g. search, product_details)
• args: the parameters for that operation

The tool description lists every operation and its required parameters. Example call to the jsearch tool:

{
  "operation": "search",
  "args": { "query": "site reliability engineer remote", "country": "us" }
}

Arguments are validated and type-coerced before the request is sent, and responses return the OpenWeb Ninja data payload plus a request_id.

Environment variables

Available tools (42)

Search & discovery: realtimewebsearch, realtimenewsdata, realtimenewssearch, realtimeforumssearch, websearchautocomplete, realtimeimagesearch, reverseimagesearch, realtimelensdata, realtimevideosearch, realtimeshortssearch, aioverviews, googleaimode, sociallinks_search

Local & maps: localbusinessdata, yelpbusinessdata, trustpilotcompanyandreviews, localranktracker, drivingdirections, waze, evchargefinder

Jobs & companies: jsearch, jobsalarydata, realtimeglassdoordata

Commerce & product: realtimeamazondata, realtimeproductsearch, realtimewalmartdata, realtimeebaydata, realtimecostcodata, realtimewayfairdata, realtimebooksdata, playstore_apps

Real estate: realtimezillowdata, realtimeredfin_data

Finance & events: realtimefinancedata, realtimeeventsdata

Contact & enrichment: websitecontactsscraper, email_search

Utility: web_unblocker

LLM relays: chatgpt, gemini, copilot

Access: subscribe (add an API's free tier on demand)

Development

Shortened. The full README is on GitHub.