4get MCP Server
A MCP server that provides seamless access to the 4get Meta Search engine API for LLM clients via FastMCP.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
A MCP server that provides seamless access to the 4get Meta Search engine API for LLM clients via FastMCP.
A MCP server that provides seamless access to the 4get.ca Meta Search Engine API for LLM clients via FastMCP.
engine parameter without memorizing query strings# Install dependencies
uv sync
# Run the server
uv run -m mcp_4get
# Or use mise
mise run
The server is highly configurable via environment variables. All settings have sensible defaults for the public https://4get.ca instance.
uv run -m mcp_4get
# With custom configuration
export FOURGET_BASE_URL="https://my-4get-instance.com"
export FOURGET_PASS="my-secret-token"
export FOURGET_CACHE_TTL="300"
export FOURGET_MAX_RETRIES="5"
uv run -m mcp_4get
You can integrate the 4get MCP server with popular IDEs and AI assistants. Here are configuration examples:
Add this to your Cursor MCP configuration (~/.cursor/mcp.json):
{
"mcpServers": {
"4get": {
"command": "uvx",
"args": [
"mcp_4get@latest"
],
"env": {
"FOURGET_BASE_URL": "https://4get.ca"
}
}
}
}
Add this to your Codex MCP configuration (~/.codex/config.toml):
[mcp_servers.4get]
command = "uvx"
args = ["mcp_4get@latest"]
env = { FOURGET_BASE_URL = "https://4get.ca" }
Note: Replace /path/to/your/mcp-4get with the actual path to your project directory.
The server exposes three powerful search tools with comprehensive response formatting:
fourget_web_searchfourget_web_search(
query: str,
page_token: str = None, # Use 'npt' from previous response
extended_search: bool = False, # Enable extended search mode
engine: str = None, # Pick a scraper from the supported engine list
extra_params: dict = None # Language, region, etc.
)
Response includes: web[], answer[], spelling, related[], npt
fourget_image_searchfourget_image_search(
query: str,
page_token: str = None, # Use 'npt' from previous response
engine: str = None, # Pick a scraper from the supported engine list
extra_params: dict = None # Size, color, type filters
)
Response includes: image[], npt
fourget_news_searchfourget_news_search(
query: str,
page_token: str = None, # Use 'npt' from previous response
engine: str = None, # Pick a scraper from the supported engine list
extra_params: dict = None # Date range, source filters
)
Response includes: news[], npt
All MCP tools accept an optional engine argument that maps directly to the 4get scraper query parameter. This shorthand overrides any scraper value you may include in extra_params.
If you need to pass additional 4get query parameters (such as country or language), continue to supply them through extra_params.
All tools support pagination via the npt (next page token):
# Get first page
result = await client.web_search("python programming")
# Get next page if available
if result.get('npt'):
next_page = await client.web_search("ignored", page_token=result['npt'])
You can reuse the bundled async client outside MCP for direct API access:
import asyncio
from mcp_4get.client import FourGetClient
from mcp_4get.config import Config
async def main() -> None:
client = FourGetClient(Config.from_env())
data = await client.web_search(
"model context protocol",
options={"scraper": "mullvad_brave"},
)
for result in data.get("web", []):
print(result["title"], "->", result["url"])
asyncio.run(main())
This allows you to integrate 4get search capabilities directly into your Python applications without going through the MCP protocol.
FourGetAuthError: Rate limited or invalid authenticationFourGetAPIError: API returned non-success statusFourGetTransportError: Network or HTTP protocol errorsFourGetError: Generic client errorsAll settings are validated on startup with clear error messages for misconfigurations.
Based on the real 4get API, responses include rich metadata:
{
"status": "ok",
"web": [
{
"title": "Example Result",
"description": "Result description...",
"url": "https://example.com",
"date": 1640995200,
"type": "web"
}
],
"answer": [
{
"title": "Featured Answer",
"description": [{"type": "text", "value": "Answer content..."}],
"url": "https://source.com",
"table": {"Key": "Value"}
}
],
"spelling": {
"type": "no_correction",
"correction": null
},
"related": ["related search", "terms"],
"npt": "pagination_token_here"
}
This project uses several tools to streamline the development process:
mise is used for managing project-level dependencies and environment variables. mise helps ensure consistent development environments across different machines.
To get started with mise:
mise install in the project root to set up the development environment.Environment Variable Overrides: You can override any environment variable by creating a .mise.local.toml file in the project root:
[env]
FOURGET_BASE_URL = "https://your-custom-4get-instance.com"
FOURGET_CACHE_TTL = "300"
# Add any other environment variables you want to override
This file is automatically loaded by mise and allows you to customize your local development environment without modifying the shared configuration files.
UV is used for dependency management and packaging. It provides a clean, version-controlled way to manage project dependencies.
To set up the project with UV:
uv sync to install project dependencies.Add this to your Cursor MCP configuration (~/.cursor/mcp.json):
{
"mcpServers": {
"4get": {
"command": "uv",
"args": [
"run",
"--project",
"/path/to/your/mcp-4get",
"-m",
"src"
],
"env": {
"FOURGET_BASE_URL": "https://4get.ca"
}
}
}
}
Add this to your Codex MCP configuration (~/.codex/config.toml):
[mcp_servers.4get]
command = "uv"
args = ["run", "--project", "/path/to/your/mcp-4get", "-m", "src"]
env = { FOURGET_BASE_URL = "https://4get.ca" }
Note: Replace /path/to/your/mcp-4get with the actual path to your project directory.
Comprehensive test suite with unit, integration, and performance tests:
# Run all tests
uv run pytest
# Run only fast unit tests (exclude integration)
uv run pytest -m "not integration"
# Run integration tests with real 4get API
uv run pytest -m integration
# Run with coverage
uv run pytest --cov=src
# Run specific test categories
uv run pytest tests/test_cache.py # Cache behavior tests
uv run pytest tests/test_client.py # Client and retry logic tests
uv run pytest tests/test_integration.py # Real API integration tests
The tests follow FastMCP testing guidelines with comprehensive fixtures and proper isolation.
uv run ruff checkuv run ruff formatGPLv3 License - see LICENSE file for details.
A MCP server that provides seamless access to the 4get.ca Meta Search Engine API for LLM clients via FastMCP.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
MCP 4get roda localmente via stdio.
Última verificação: 2026-11-15. A MCP server that provides seamless access to the 4get.ca Meta Search Engine API for LLM clients via FastMCP.