Inspect and manually use a synthetic Tool’s actual instance data.
Some Tools have a synthetic browser application. Open it to inspect the same data your agent reads or changes through the Tool’s API or MCP interface.A catalog page describes a Tool. An instance page describes the particular running copy in your selected project and environment.
Open an instance created through the CLI, SDK, or manual web setup.
Use its browser preview or Open Tool action when available.
The instance view shows current status, expiry, starting dataset, activity/history, and connection details. A Tool without a browser app can expose a supported record view instead.Opening a browser app does not connect or launch your agent. Run the agent from your CLI or SDK workflow.
The browser app uses the instance’s actual selected dataset. If your CLI or SDK created the instance with a saved dataset, those are the records it displays. Browser writes and agent Tool calls affect the same synthetic state.Starter data is explicitly authored synthetic input. Firedrill does not read your production service account to populate it.
The portal obtains a short-lived instance-specific browser grant. Opening the Tool in another tab uses a fresh grant, not your account’s operator credential.If an embedded preview is blocked by browser cookie policy, use Open Tool to open it separately. An expired connection, reset, ended instance, or revoked account access cannot be made active by refreshing an old URL.
Its retained metadata, activity, and associated results remain inspectable according to retention. The live preview and active connection are unavailable. You can deliberately start another instance from the chosen build and dataset; ending an instance does not erase its recorded outcomes.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Firedrill","description":"Simulate AI agents across scenarios, configurations, and repeated trials","colors":{"primary":"#3157D5","light":"#5272DE","dark":"#5272DE"},"logo":{"light":"https://mintcdn.com/firedrill/sWeyeTM66Pjv8_YB/logo/light.svg?fit=max\u0026auto=format\u0026n=sWeyeTM66Pjv8_YB\u0026q=85\u0026s=608d25ab5f97ad95a8d3e8c9ced0cb6d","dark":"https://mintcdn.com/firedrill/sWeyeTM66Pjv8_YB/logo/dark.svg?fit=max\u0026auto=format\u0026n=sWeyeTM66Pjv8_YB\u0026q=85\u0026s=fa12225848791186ced26f7609685612"},"favicon":"https://mintcdn.com/firedrill/sWeyeTM66Pjv8_YB/favicon.svg?fit=max\u0026auto=format\u0026n=sWeyeTM66Pjv8_YB\u0026q=85\u0026s=cae3a93e3c384028863580e7ed05f4f9","api":{"playground":{"display":"none"}},"navbar":{"links":[{"href":"https://firedrill.run","label":"Firedrill"},{"href":"https://firedrill.run/agents","label":"For agents"}],"primary":{"type":"button","label":"Open Firedrill","href":"https://app.firedrill.run"}},"seo":{"metatags":{"canonical":"https://docs.firedrill.run"}},"fonts":{"family":"Inter","weight":450},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Open Firedrill","icon":"arrow-up-right-from-square","href":"https://app.firedrill.run"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"firedrill","hasAudioNarration":false,"actualSubdomain":"firedrill","customDomains":["docs.firedrill.run"],"gitSource":{"type":"github","owner":"firedrill-tools","repo":"firedrill-developer-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ad70e01d6c125375d923afd","collectionId":"8a442383-941c-43b0-8344-f7f7828b9c25","liveDeploymentHistoryId":"6ad70e01d6c125375d923afd","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ad70e01d6c125375d923afd","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API reference","count":80},{"language":"default","tag":"Control API","count":78},{"language":"default","tag":"Documentation","count":44},{"language":"default","tag":"tools","count":18},{"language":"default","tag":"Simulations and evidence","count":10},{"language":"default","tag":"tool-lifecycle","count":10},{"language":"default","tag":"Synthetic Tools","count":8},{"language":"default","tag":"reports","count":8},{"language":"default","tag":"Core concepts","count":6},{"language":"default","tag":"assessment","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"guides/tool-apps","slug":"/guides/tool-apps","pageMetadata":{"title":"Tool browser apps","description":"Inspect and manually use a synthetic Tool's actual instance data.","href":"/guides/tool-apps"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Inspect and manually use a synthetic Tool’s actual instance data.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Some Tools have a synthetic browser application. Open it to inspect the same data your agent reads or changes through the Tool’s API or MCP interface.`}),`\n`,_jsxs(_components.p,{children:[`A catalog page describes a Tool. An `,_jsx(_components.strong,{children:`instance`}),` page describes the particular running copy in your selected project and environment.`]}),`\n`,_jsx(Heading,{level:`2`,id:`open-an-instance`,children:`Open an instance`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open `,_jsx(_components.strong,{children:`Tools`}),` in `,_jsx(_components.a,{href:`https://app.firedrill.run`,children:`Firedrill`}),`.`]}),`\n`,_jsx(_components.li,{children:`Select the intended project and environment.`}),`\n`,_jsx(_components.li,{children:`Open an instance created through the CLI, SDK, or manual web setup.`}),`\n`,_jsxs(_components.li,{children:[`Use its browser preview or `,_jsx(_components.strong,{children:`Open Tool`}),` action when available.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`The instance view shows current status, expiry, starting dataset, activity/history, and connection details. A Tool without a browser app can expose a supported record view instead.`}),`\n`,_jsx(_components.p,{children:`Opening a browser app does not connect or launch your agent. Run the agent from your CLI or SDK workflow.`}),`\n`,_jsx(Heading,{level:`2`,id:`starting-data-is-shared`,children:`Starting data is shared`}),`\n`,_jsx(_components.p,{children:`The browser app uses the instance’s actual selected dataset. If your CLI or SDK created the instance with a saved dataset, those are the records it displays. Browser writes and agent Tool calls affect the same synthetic state.`}),`\n`,_jsx(_components.p,{children:`Starter data is explicitly authored synthetic input. Firedrill does not read your production service account to populate it.`}),`\n`,_jsx(Heading,{level:`2`,id:`access-is-scoped-and-temporary`,children:`Access is scoped and temporary`}),`\n`,_jsx(_components.p,{children:`The portal obtains a short-lived instance-specific browser grant. Opening the Tool in another tab uses a fresh grant, not your account’s operator credential.`}),`\n`,_jsxs(_components.p,{children:[`If an embedded preview is blocked by browser cookie policy, use `,_jsx(_components.strong,{children:`Open Tool`}),` to open it separately. An expired connection, reset, ended instance, or revoked account access cannot be made active by refreshing an old URL.`]}),`\n`,_jsx(Heading,{level:`2`,id:`after-the-instance-ends`,children:`After the instance ends`}),`\n`,_jsx(_components.p,{children:`Its retained metadata, activity, and associated results remain inspectable according to retention. The live preview and active connection are unavailable. You can deliberately start another instance from the chosen build and dataset; ending an instance does not erase its recorded outcomes.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Tool browser apps","description":"Inspect and manually use a synthetic Tool's actual instance data.","href":"/guides/tool-apps"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Open an instance","slug":"open-an-instance","depth":2,"children":[]},{"title":"Starting data is shared","slug":"starting-data-is-shared","depth":2,"children":[]},{"title":"Access is scoped and temporary","slug":"access-is-scoped-and-temporary","depth":2,"children":[]},{"title":"After the instance ends","slug":"after-the-instance-ends","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"firedrill","siteName":"Firedrill","title":"Tool browser apps - Firedrill","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-18T11:28:24.807Z","originalFileLocation":"guides/tool-apps.md"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Inspect and manually use a synthetic Tool\u0026#x27;s actual instance data.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Firedrill\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Tool browser apps - Firedrill\">\u003cmeta data-mint-head property=\"og:description\" content=\"Inspect and manually use a synthetic Tool\u0026#x27;s actual instance data.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Firedrill\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.firedrill.run/guides/tool-apps\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://firedrill.mintlify.app/_mintlify/api/og/v2?division=Synthetic+Tools\u0026amp;title=Tool+browser+apps\u0026amp;description=Inspect+and+manually+use+a+synthetic+Tool%27s+actual+instance+data.\u0026amp;theme=211def18583054cfab550cb1\u0026amp;signature=6308f14916970824ff116d892e932bfd693ec753e056dca01eeb360001d35495\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Tool browser apps - Firedrill\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Inspect and manually use a synthetic Tool\u0026#x27;s actual instance data.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://firedrill.mintlify.app/_mintlify/api/og/v2?division=Synthetic+Tools\u0026amp;title=Tool+browser+apps\u0026amp;description=Inspect+and+manually+use+a+synthetic+Tool%27s+actual+instance+data.\u0026amp;theme=211def18583054cfab550cb1\u0026amp;signature=6308f14916970824ff116d892e932bfd693ec753e056dca01eeb360001d35495\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/firedrill/4doC3Wuxr0HFEQEu/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Firedrill\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3157D5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.firedrill.run/guides/tool-apps\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/tool-apps.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.firedrill.run/#organization\",\"name\":\"Firedrill\",\"url\":\"https://docs.firedrill.run\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/firedrill/sWeyeTM66Pjv8_YB/logo/light.svg?fit=max\u0026auto=format\u0026n=sWeyeTM66Pjv8_YB\u0026q=85\u0026s=608d25ab5f97ad95a8d3e8c9ced0cb6d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.firedrill.run#website\",\"name\":\"Firedrill\",\"url\":\"https://docs.firedrill.run\",\"publisher\":{\"@id\":\"https://docs.firedrill.run/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.firedrill.run/guides/tool-apps#webpage\",\"url\":\"https://docs.firedrill.run/guides/tool-apps\",\"name\":\"Tool browser apps\",\"description\":\"Inspect and manually use a synthetic Tool's actual instance data.\",\"dateModified\":\"2026-10-18T11:28:24.807Z\",\"isPartOf\":{\"@id\":\"https://docs.firedrill.run#website\"},\"breadcrumb\":{\"@id\":\"https://docs.firedrill.run/guides/tool-apps#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.firedrill.run/guides/tool-apps#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Synthetic Tools\",\"item\":\"https://docs.firedrill.run/guides/install-tools\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tool browser apps\",\"item\":\"https://docs.firedrill.run/guides/tool-apps\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.firedrill.run/guides/tool-apps#article\",\"headline\":\"Tool browser apps\",\"name\":\"Tool browser apps\",\"description\":\"Inspect and manually use a synthetic Tool's actual instance data.\",\"url\":\"https://docs.firedrill.run/guides/tool-apps\",\"mainEntityOfPage\":{\"@id\":\"https://docs.firedrill.run/guides/tool-apps#webpage\"},\"dateModified\":\"2026-10-18T11:28:24.807Z\",\"publisher\":{\"@id\":\"https://docs.firedrill.run/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.firedrill.run#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Firedrill\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Firedrill","nav":{"global":{"anchors":[{"anchor":"Open Firedrill","icon":"arrow-up-right-from-square","href":"https://app.firedrill.run"}]},"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Get started","pages":[{"title":"Firedrill","href":""},{"title":"Run your first simulation","href":"/quickstart"},{"title":"AI agent examples by framework and stack","sidebarTitle":"Framework examples","href":"/guides/examples"},{"title":"How Firedrill works","href":"/concepts/how-it-works"},{"title":"Choose your workflow","href":"/reference/choose-a-workflow"}]},{"group":"Coding agents","pages":[{"title":"Coding-agent setup","href":"/guides/coding-agents"},{"title":"Operator MCP","href":"/guides/control-mcp"},{"title":"Connect your agent's real entry point","href":"/guides/example-agents"}]},{"group":"Simulations and evidence","pages":[{"title":"Simulate your application","href":"/guides/simulate-and-test"},{"title":"Run your first simulation","href":"/guides/run-first-drill"},{"title":"Repeat and coordinate simulations","href":"/guides/simulations"},{"title":"Vary scenario inputs","href":"/guides/scenario-matrices"},{"title":"Save and reuse scenarios","href":"/guides/reusable-scenarios"},{"title":"Score meaning and enforce exact requirements","href":"/guides/scoring"},{"title":"Compare target and model configurations","href":"/guides/model-benchmarks"},{"title":"Capture a browser workflow","href":"/guides/browser-testing"},{"title":"Attach logs, files, and media","href":"/guides/capture"},{"title":"Results and evidence","href":"/guides/results"}]},{"group":"Synthetic Tools","pages":[{"title":"Start synthetic Tools","href":"/guides/install-tools"},{"title":"Connect your agent to synthetic Tools","description":"Route only the dependencies your agent uses into scoped synthetic instances.","href":"/guides/connect-agent"},{"title":"Tool browser apps","href":"/guides/tool-apps"},{"title":"Starting data","description":"Choose explicit synthetic records for each Tool and scenario.","href":"/guides/starting-data"},{"title":"Save and reuse datasets","href":"/guides/saved-datasets"},{"title":"Control state and time","href":"/guides/control-state-time"},{"title":"Tool lifetime and history","href":"/guides/sessions"},{"title":"Author a synthetic Tool","href":"/guides/create-tool-package"}]},{"group":"Automation","pages":[{"title":"Run simulations in CI","href":"/guides/ci"},{"title":"Pull-request simulations","href":"/guides/pull-request-ci"},{"title":"Command and HTTP agents","href":"/guides/callbacks"}]},{"group":"Web app and access","pages":[{"title":"Use the web app","href":"/guides/web-app"},{"title":"Projects and environments","href":"/guides/projects-builds"},{"title":"Team access and machine credentials","href":"/guides/team"},{"title":"Security and data boundaries","href":"/guides/security"}]},{"group":"Core concepts","pages":[{"title":"Synthetic Tools","href":"/concepts/tools"},{"title":"Isolated state","href":"/concepts/world-state"},{"title":"Scenarios","href":"/concepts/scenarios"},{"title":"Tool access","href":"/concepts/actors-personas"},{"title":"Scenarios, batches, and runs","href":"/concepts/drills-runs"},{"title":"Evidence and reset","href":"/concepts/evidence-reset"}]},{"group":"Files and reference","pages":[{"title":"Simulation files","href":"/guides/project-files"},{"title":"Project structure","href":"/reference/project-structure"},{"title":"Tool contract","href":"/reference/tool-contract"},{"title":"Glossary","href":"/reference/glossary"},{"title":"Troubleshooting","href":"/reference/troubleshooting"}]}]},{"tab":"CLI","icon":"square-terminal","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"SDKs","icon":"code","pages":[{"title":"SDKs","href":"/sdk/overview"}]},{"tab":"API reference","icon":"brackets-curly","pages":[{"title":"API reference","href":"/api-reference/overview"}]}]},"basePath":"","title":"Tool browser apps - Firedrill","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}