Bob", "Charlie"] ``` Using pattern: `data[*].name` saves **99% tokens** and eliminates model hallucination from irrelevant data. ## Installation For most IDEs, use the `uvx` tool to run the server. ```json { "mcpServers": { "fetch-jsonpath-mcp": { "command": "uvx", "args": [ "fetch-jsonpath-mcp" ] } } } ```

Install in Claude Code

```bash claude mcp add fetch-jsonpath-mcp -- uvx fetch-jsonpath-mcp ```

Install in Cursor

```json { "mcpServers": { "fetch-jsonpath-mcp": { "command": "uvx", "args": ["fetch-jsonpath-mcp"] } } } ```

Install in Windsurf

Add this to your Windsurf MCP config file. See [Windsurf MCP docs](https://docs.windsurf.com/windsurf/cascade/mcp) for more info. #### Windsurf Local Server Connection ```json { "mcpServers": { "fetch-jsonpath-mcp": { "command": "uvx", "args": ["fetch-jsonpath-mcp"] } } } ```

Install in VS Code

```json "mcp": { "servers": { "fetch-jsonpath-mcp": { "type": "stdio", "command": "uvx", "args": ["fetch-jsonpath-mcp"] } } } ```

## Development Setup ### 1. Install Dependencies ```bash uv sync ``` ### 2. Start Demo Server (Optional) ```bash # Install demo server dependencies uv add fastapi uvicorn # Start demo server on port 8080 uv run demo-server ``` ### 3. Run MCP Server ```bash uv run fetch-jsonpath-mcp ``` ## Demo Server Data The demo server at `http://localhost:8080` returns: ```json { "foo": [{"baz": 1, "qux": "a"}, {"baz": 2, "qux": "b"}], "bar": { "items": [10, 20, 30], "config": {"enabled": true, "name": "example"} }, "metadata": {"version": "1.0.0"} } ``` ## Available Tools ### `fetch-json` Extract JSON data using JSONPath patterns with support for all HTTP methods. ```json { "name": "fetch-json", "arguments": { "url": "http://localhost:8080", "pattern": "foo[*].baz", "method": "GET" } } ``` Returns: `[1, 2]` **Parameters:** - `url` (required): Target URL - `pattern` (optional): JSONPath pattern for data extraction - `method` (optional): HTTP method (GET, POST, PUT, DELETE, etc.) - Default: "GET" - `data` (optional): Request body for POST/PUT requests - `headers` (optional): Additional HTTP headers ### `fetch-text` Fetch web content with intelligent text extraction. **Defaults to Markdown format** for better readability. ```json { "name": "fetch-text", "arguments": { "url": "http://localhost:8080", "output_format": "clean_text" } } ``` Returns: Clean text representation of the JSON data **Output Formats:** - `"markdown"` (default): Converts HTML to clean Markdown format - `"clean_text"`: Pure text with HTML tags removed - `"raw_html"`: Original HTML content **Parameters:** - `url` (required): Target URL - `method` (optional): HTTP method - Default: "GET" - `data` (optional): Request body for POST/PUT requests - `headers` (optional): Additional HTTP headers - `output_format` (optional): Output format - Default: "markdown" ### `batch-fetch-json` Process multiple URLs with different JSONPath patterns concurrently. ```json { "name": "batch-fetch-json", "arguments": { "requests": [ {"url": "http://localhost:8080", "pattern": "foo[*].baz"}, {"url": "http://localhost:8080", "pattern": "bar.items[*]"} ] } } ``` Returns: `[{"url": "http://localhost:8080", "pattern": "foo[*].baz", "success": true, "content": [1, 2]}, {"url": "http://localhost:8080", "pattern": "bar.items[*]", "success": true, "content": [10, 20, 30]}]` **Request Object Parameters:** - `url` (required): Target URL - `pattern` (optional): JSONPath pattern - `method` (optional): HTTP method - Default: "GET" - `data` (opt

Fetch Jsonpath Mcp

Tools

fetch-json

fetch-text

batch-fetch-json

batch-fetch-text

Server Config