About Json Query MCP
Json Query MCP is an MCP server published by mgraczyk in the Developer Tools category: an MCP server that gives AI agents tools to query large JSON files.
The repository has 11 stars and 4 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/mgraczyk/json-query-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (3)
json_query_jsonpathQuery a JSON file using JSONPath. Use to get values precisely from large JSON files.
Parameters not published.
json_query_search_keysSearch for keys in a JSON file. Use when you do not know the path to a key in a large JSON file, but have some idea what the key is.
Parameters not published.
json_query_search_valuesSearch for values in a JSON file. Use when you do not know the path to a value in a large JSON file, but have some idea what the value is.
Parameters not published.
Ask AI
Ask AI about Json Query MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
JSON Query MCP
A Model Context Protocol (MCP) server for querying large JSON files. This server provides tools for working with large JSON data that can be used by LLM models implementing the Model Context Protocol.
Features
- Query JSON files using JSONPath expressions
- Search for keys similar to a query string
- Search for values similar to a query string
Example
Here is an example of the Cursor Agent using the tool to read a a very large (>1M character) JSON Swagger definition, and extracting a small portion to write a typescript interface.

Usage
npx json-query-mcp
Installation in Cursor
Add the following to your cursor mcp json
(on macOS this is /Users/$USER/.cursor/mcp.json)
{
"mcpServers": {
... other mcp servers
"json-query": {
"command": "npx",
"args": [<local path to this repo>],
},
}
}
Development
# Run in development mode
npm run dev
# Run tests
npm test
# Format code
npm run format
# Lint code
npm run lint
# Fix lints
npm run fix
License
MIT
README fetched from the repository 7 days ago. The original is authoritative.