well_preview_provider_export

io.github.WellApp-ai/well-mcp · Verify this server

Show the user what Well can fetch from a provider's own web app, and the Deploy action that fetches it. Draws a "deploy agent" card with one row per provider. Each row lists every file the agent can download, each with its `export_id`, label, format and whether it is `selected`. The row's `deploy_url` opens Well's `/collect` page, the same page that deploys the invoice agents, naming the provider in `providers` and the selected files in `fetch`. When the user starts the export there, the Well browser extension opens the provider in a new tab and its agent downloads the selected files, one at a time, in the user's own signed-in session, then files each one in this workspace. Use it when the user wants data from a provider that Well cannot connect to directly, asks to "download", "export", "fetch everything" or "get the CSV" from a provider, or when the connector route is unavailable. Pass `provider_slugs` to preview the providers the user named; omit it to show every provider Well can fetch from. Pass `export_ids` when the user asked for specific files; omit it to fetch every file. A provider Well has no export for comes back in `unknown_provider_slugs`, and a file it does not list in `unknown_export_ids`: say plainly that Well cannot fetch it yet. A row whose `export_ids` matched none of its files selects nothing and has a null `deploy_url`: offer its listed files instead. This tool starts nothing and downloads nothing. Never say a file was fetched by this call: the run happens in the browser extension after the user clicks, and the extension's side panel reports it. A row's `last_run` is the one record of an earlier run in this workspace: when the user asks whether a run worked, report its `status`, when it ended and its `files_filed` as returned, and nothing more. When `refresh_due` is true, offer to fetch the files again with the row's Deploy; Well never re-runs on its own. When `harness_access` is `refused`, no row has a `deploy_url`: say this browser agent is not open to the user's account yet, and offer the upload route. When the user wants several providers at once and `deploy_all_url` is set, offer it: it deploys every row with a link, one provider after the other. When it is null, offer each row's own `deploy_url`. Give each `deploy_url` and `deploy_all_url` as returned and never build or edit one. The run needs the Well browser extension, and the user must be signed in to the provider in that browser; when a login or a two-factor code stands in the way, the agent hands the tab back to the user. When `error` is set, report it and do not read `harness_access`. When the token authorizes one workspace, call this directly — no workspace call is needed first. When it authorizes several, this read will not guess which one you mean: pass `workspace_id` on the call.