{
  "access": "public",
  "type": "tutorial",
  "format": "markdown",
  "title": "JSON-RPC Inspector Guide",
  "chunked": true,
  "url": "https://library.datagrout.ai/jsonrpc-inspector",
  "summary": "**Test JSON-RPC endpoints with live request and response inspection**",
  "content_markdown": "# JSONRPC Inspector\n\n**Test JSON-RPC endpoints with live request and response inspection**\n\nThe JSONRPC Inspector is a free interactive tool for sending JSON-RPC 2.0 requests to any endpoint. No session management, no SSE -- just HTTP POST. Works with DataGrout servers, external APIs, and anything that speaks JSON-RPC.\n\n---\n\n## Interface\n\nThe inspector has two panels:\n\n**Left panel** -- configuration:\n\n1. **Quick Start**: Select from your DataGrout servers that have JSON-RPC enabled (auto-fills URL and auth, converts `/mcp` to `/rpc`) or choose a pre-configured example\n2. **Endpoint URL**: The JSON-RPC endpoint to call\n3. **Authentication**: None, Bearer Token, Basic Auth, or OAuth 2.0\n4. **Action** (DataGrout servers): Dropdown with common actions:\n   - `tools.list` -- List available tools\n   - `tools.call` -- Call a tool\n   - `tools.get` -- Get tool details\n   - Custom method -- type any method name\n5. **Method Name** (external servers): Free-text input for any JSON-RPC method\n6. **Parameters**: JSON textarea for the request params (defaults to `{}`)\n7. **Execute Request**: Send the request\n\n**Right panel** -- response log:\n\nEach response shows a timestamp, method name badge, latency, and formatted JSON. Each entry has Copy JSON and Export cURL buttons.\n\nA rate limit indicator shows remaining calls per hour.\n\n---\n\n## Getting Started\n\n### Test a DataGrout Server\n\n1. Open the JSONRPC Inspector\n2. Click **Your Servers** in Quick Start and select a server\n3. URL and auth fill automatically (URL points to `/rpc`)\n4. Select **tools.list** from the action dropdown\n5. Click **Execute Request**\n6. Browse the response to see all available tools\n\n### Test an External Endpoint\n\n1. Enter any JSON-RPC endpoint URL\n2. Configure authentication if needed\n3. Type the method name (e.g. `getInfo`, `eth_blockNumber`)\n4. Enter parameters as JSON\n5. Execute and inspect the response\n\n### Call a Tool\n\n1. Select **tools.call** from the action dropdown\n2. Enter parameters:\n\n```json\n{\n  \"name\": \"salesforce@1/get_leads@1\",\n  \"arguments\": {\"limit\": 10}\n}\n```\n\n3. Execute and inspect the response\n\n---\n\n## When to Use JSONRPC vs MCP Inspector\n\nUse the **JSONRPC Inspector** when you want simple, stateless HTTP testing. Each request is independent -- no initialization handshake, no session to manage.\n\nUse the **MCP Inspector** when you need to test the full MCP lifecycle including SSE streaming, session initialization, and server-pushed events.\n\n---\n\n## Related\n\n- [MCP Inspector](mcp-inspector) -- Full MCP protocol testing with SSE\n- [Quick Start](quick-start) -- Set up your first server\n- [JSONRPC Transport](jsonrpc) -- JSONRPC transport documentation\n"
}