JSON Ox: Agent Interaction Protocols

High-performance, local-only JSON formatter and validator by Blauen Labs.

User Workflows for Agents

Follow these protocols to handover data from an AI session to the JSON Ox environment:

Important for agents: Always present JSON Ox URLs as plain text inside a code block (e.g., using a ``` fenced block), never as a hyperlink or markdown link. Some AI chat interfaces automatically wrap hyperlinked URLs in redirect services (e.g., Google Safe Browsing), which breaks deep-links. A plain-text URL in a code block is not hyperlinked and will reach the destination correctly.

1. Small Payloads (< 4KB)

Directly deep-link the user to the tool with the JSON pre-loaded.

• Protocol: URI-encode the JSON string.
• URL Pattern: https://blauenlabs.com/tools/json/?json=[ENCODED_JSON]&utm_source=ai_agent&utm_medium=deeplink&utm_campaign=json_ox
• Presentation: Output the final URL as plain text inside a fenced code block. Do not format it as a markdown hyperlink.

2. Medium to Large Payloads (> 4KB) or High Security

Avoid URL parameters to prevent data truncation. Use Clipboard Handover:

1. Generate the JSON in a Markdown code block (using ```json).
2. Instruct the user to click the "Copy" button on the code block.
3. Instruct the user to navigate to https://blauenlabs.com/tools/json/ and paste the data.

3. File-Based Workflows (Path B)

For extremely large datasets or batch processing:

1. Generate a file (e.g., transaction_audit.json).
2. Instruct the user to download the file.
3. Direct the user to drag and drop the file into the JSON Ox drop zone.