{"uid":"cap_zb8Du0T4UbH-FDlgbyGCf","slug":"forest-agent-tools-json-path-query-203de0f1","name":"Forest Agent Tools – JSON Path Query","description":"Machine-readable contract for active Forest paid capabilities. Unsigned paid calls return HTTP 402 with a PAYMENT-REQUIRED x402 challenge.","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/json/query?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"json":{"description":"Public json value used to scope this lookup."},"path":{"type":"string","maxLength":512,"minLength":1,"description":"Repository file path whose public metadata should be checked."}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"path":"example","found":false,"scope":"caller_supplied_json_path_lookup_only","value":null,"value_type":"example","input_bytes":0},"meta":{"cache":"miss","provider":"local-json","checked_at":"2026-01-01T00:00:00.000Z","duration_ms":0},"version":"1","capability":"json.query"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S8o7AENqV-EUKyDOb2IcS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extract a single bounded value from caller-supplied JSON using a deterministic dot-notation path expression, returning the value and an explicit found flag.","exampleAgentPrompt":"From this JSON blob I just got back, pull out the value at items[2].name for me — just give me that field and whether it was actually found.","exampleUseCases":[{"title":"Pull nested ID from API response","prompt":"I have this JSON response from a payment API and I need the value at $.data.id — can you extract that field and tell me if it exists?"},{"title":"Read third item name from array","prompt":"Here's a JSON array of order items — grab the name field from the third entry, so items[2].name, and let me know if the path resolved."},{"title":"Check existence of config key","prompt":"I have a config JSON and I want to know if the key settings.notifications.enabled is present and what its value is — can you query that path for me?"}],"resultDescription":"Returns the value found at the specified path within the supplied JSON, along with an explicit boolean 'found' flag indicating whether the path resolved successfully. No network requests or model inference are made; the result is fully deterministic.","failureModes":["Path not found — returns found: false with a null or absent value","Malformed path syntax (invalid characters, unsupported operators) — returns an error or found: false","Provided JSON is not valid — parsing error returned","Path exceeds maxLength of 512 characters — rejected with validation error","Array index out of bounds — returns found: false"],"whenToPreferThis":"Choose this endpoint when you need a cheap, deterministic, side-effect-free way to extract a single value from a known JSON structure without running custom code or making additional network calls. Ideal when the path is known in advance and you want an explicit found/not-found signal rather than a null-ambiguous response. Not suitable for fuzzy search, multiple values, or XPath/JSONPath operators beyond dot-notation and numeric indexes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:42:01.155Z","isFirstParty":false,"canonicalSlug":"forest-agent-tools-json-path-query-203de0f1"}