# The JQ API

> The JQ API is a freemium MCP server for developer tools. Hosted jq for JSON in your chat or HTTP workflow, with REST and MCP and no install. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://thejqapi.com
- **MCP Registry name:** com.thejqapi/jq-api
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-14

## About

The JQ API runs jq compiled to WebAssembly on Cloudflare Workers, so there is nothing to install or host. Its `process_json` tool takes inline JSON, a public HTTPS URL or an upload ID plus a jq filter, which lets an agent reshape a large API response without pasting it all into the model's context. Filters can use jq built-ins, regular expressions, custom functions and request-supplied modules, and the same engine is available through a REST endpoint and a Zapier action.

Uploads are kept privately for 15 minutes and can be deleted early; documents are limited to 5 MiB. The tool cannot read local files, run shell commands or reach connected accounts. JSON, filters, URLs and results are kept out of application logs on every plan, but free use records IP or UUID quota counters and source analytics, while paid use skips those.

There are three ways to pay: free at 100 queries a day per IP, or 1,000 with any UUID sent as a bearer token; 0.005 USDC per attempt; or a 2 USDC pass for 30 days of unlimited queries. Payments use USDC on Base through x402 with no automatic renewal, and runtime errors on paid per-query calls are chargeable. Operator details name Craftsman Founder LLC.

## Features

- **Three input modes:** Process inline JSON, a public HTTPS URL or a stored upload.
- **Full jq filters:** Built-ins, regex, variables, slurp and request-supplied modules.
- **Temporary uploads:** Store JSON for 15 minutes to query it repeatedly, then delete it.
- **REST and MCP:** One engine and one shared daily quota across both interfaces.
- **Quota check:** get_quota reports remaining calls.
- **Privacy pass:** Optional paid access with no quota counters or usage analytics.

## Good for

- Extract fields from an API response inside a chat
- Filter a large JSON array without loading it into context
- Shape webhook payloads in a workflow
- Run jq inside Zapier
- Query the same uploaded document several times

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http jq-api https://thejqapi.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://thejqapi.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "jq-api": {
      "url": "https://thejqapi.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "jq-api": {
      "type": "http",
      "url": "https://thejqapi.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "jq-api": {
      "serverUrl": "https://thejqapi.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "jq-api": {
      "type": "http",
      "url": "https://thejqapi.com/mcp"
    }
  }
}
```

## Tools

- `process_json`: Run a jq filter on inline JSON, a public HTTPS URL or an upload ID.
- `get_upload`: Inspect metadata of an uploaded document.
- `get_quota`: Report remaining daily calls.
- `upload_json`: Store reusable JSON for 15 minutes.
- `delete_upload`: Delete an upload early.
- `purchase_access`: Buy a paid pass.

## FAQ

### Is it free?

Yes, within limits: 100 requests a day per IP, or 1,000 a day when you send any UUID as a bearer token. No signup is needed.

### How does paid access work?

Pay 0.005 USDC per attempt, or 2 USDC for 30 days unlimited, using USDC on Base via x402. Passes do not renew automatically.

### What are the size limits?

Documents and uploads can be up to 5 MiB, and uploads stay available for 15 minutes.

### How do I add it to Claude Code?

Run claude mcp add --transport http jq-api https://thejqapi.com/mcp.

### Is The JQ API free?

The JQ API has a free plan, with paid plans for more usage or features.

### How do I add The JQ API to Claude Code?

Run this command in your terminal: claude mcp add --transport http jq-api https://thejqapi.com/mcp

### What are the best alternatives to The JQ API?

The closest alternatives to The JQ API are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/the-jq-api
