# Json Path Finder — MCP tool `findutils:json_path_finder`

Returns every match of a JSONPath expression in a JSON document: the concrete path and value of each match, the match count, and a convenience "value" (the single value when there is one match, otherwise the array of values). Supports $.a.b, ["key"], [0], [-1], [1:3], wildcards (*), recursive descent (..name) and filters ([?(@.age > 30)]).

- Category: data
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/json-path-finder/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/json-path-finder/
- Same tool on the other surface: https://findutils.com/api/json-path-finder/

## Connect

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "json_path_finder",
      "arguments": {
        "json": "{\"store\":{\"books\":[{\"title\":\"A\",\"price\":8},{\"title\":\"B\",\"price\":12}]}}",
        "path": "$.store.books[?(@.price > 10)].title"
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `json` | string | yes | The JSON document (text). |
| `path` | string | no | The JSONPath expression, e.g. "$.users[?(@.active == true)].name". Default: "$" (the root). Default: `"$"`. |

Example arguments (verified):

```json
{
  "json": "{\"store\":{\"books\":[{\"title\":\"A\",\"price\":8},{\"title\":\"B\",\"price\":12}]}}",
  "path": "$.store.books[?(@.price > 10)].title"
}
```

Decoded `json` argument (readability only — send it as a string):

```json
{
  "store": {
    "books": [
      {
        "title": "A",
        "price": 8
      },
      {
        "title": "B",
        "price": 12
      }
    ]
  }
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/json-path-finder/execute \
  -H "Content-Type: application/json" \
  -d '{
    "json": "{\"store\":{\"books\":[{\"title\":\"A\",\"price\":8},{\"title\":\"B\",\"price\":12}]}}",
    "path": "$.store.books[?(@.price > 10)].title"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/json-path-finder
```

Full REST reference: https://findutils.com/api/json-path-finder/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt