openwebninja-mcp — Claude Code MCP server: features and setup
Connects an agent to OpenWeb Ninja APIs for web search and other live data. Useful when you want the agent to retrieve those results through MCP.
claude mcp add openwebninja-mcp -e OPENWEBNINJA_API_KEY=<OPENWEBNINJA_API_KEY> -- npx -y @openwebninja/mcp-serverWhat openwebninja-mcp does
The server gives an agent tools for OpenWeb Ninja APIs covering web search, news, local businesses, jobs, products, real estate, and more. It includes 51 tools: API-specific tools plus subscribe, which adds a selected API’s free tier.
Each tool takes an operation and its arguments. The server validates those inputs, sends the request, and returns the data with a request_id. Tool schemas come from OpenAPI specifications. You need an OpenWeb Ninja API key in OPENWEBNINJA_API_KEY; without it, API requests cannot be made.
What it helps with
- search for jobs by query and country
- retrieve current product and company information
- find local businesses and their details
- give an agent web search results through MCP
Example prompts for the agent
- Use
jsearchto find remote site reliability engineer jobs in the United States. - Search for recent news about this topic and share the results.
- Find local businesses near this address.
How to install openwebninja-mcp
Platform CLI
claude mcp add openwebninja-mcp -e OPENWEBNINJA_API_KEY=<OPENWEBNINJA_API_KEY> -- npx -y @openwebninja/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add openwebninja-mcp --env OPENWEBNINJA_API_KEY=<OPENWEBNINJA_API_KEY> -- npx -y @openwebninja/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"openwebninja-mcp": {
"command": "npx",
"args": [
"-y",
"@openwebninja/mcp-server"
],
"env": {
"OPENWEBNINJA_API_KEY": "<OPENWEBNINJA_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"openwebninja-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@openwebninja/mcp-server"
],
"env": {
"OPENWEBNINJA_API_KEY": "<OPENWEBNINJA_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e OPENWEBNINJA_API_KEY=<OPENWEBNINJA_API_KEY> openwebninja-mcp npx -y @openwebninja/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about openwebninja-mcp
How do I install openwebninja-mcp in Claude Code?
Pass your OpenWeb Ninja key with this command: claude mcp add openwebninja-mcp -e OPENWEBNINJA_API_KEY=<OPENWEBNINJA_API_KEY> -- npx -y @openwebninja/mcp-server.
What does openwebninja-mcp do?
It connects agents to OpenWeb Ninja API tools for web search and data about jobs, products, news, businesses, and other categories.
What does the server need to run?
Provide an OpenWeb Ninja API key through OPENWEBNINJA_API_KEY. The server runs with npx.
