The SpecStream connector lets your AI agent act in each user's SpecStream account. Each user connects their own SpecStream access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 235 tools.
- Tools
- 235
- What they doRead · write · destructive
- 125 · 85 · 25125 read85 write25 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the SpecStream connection
In AgentKit > Connections, create a SpecStream connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'specstream'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize SpecStream:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'specstream_get_account',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "specstream"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize SpecStream:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="specstream_get_account",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their SpecStream credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolspecstream_agent_list_stepsRead the buying steps and the ways to pay.Read-onlyAgent List Steps
Read the buying steps and the ways to pay.
Inputs
This tool takes no inputs.
specstream_browser_live_viewWatch the browser's screen as it changes, in a web page.Read-onlyBrowser Live View
Watch the browser's screen as it changes, in a web page. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for browser live view.
tokenstringrequired- The token in the session's live_url.
specstream_dictation_capabilitiesRead configured hosted dictation support.Read-onlyDictation Capabilities
Read configured hosted dictation support. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_export_accountAccount export.Read-onlyExport Account
Account export. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_extract_pagesExtract API: read up to 20 pages, live from their URLs or from HTML you send, each page's main text as Markdown or plain text, its title and its published date.Read-onlyExtract Pages
Extract API: read up to 20 pages, live from their URLs or from HTML you send, each page's main text as Markdown or plain text, its title and its published date. Only a page read is charged. With no API key, the call answers 402 with a PAYMENT-REQUIRED header (base64 x402 v2 PaymentRequired): pay for this one call with x402's `exact` scheme in USDC on Base, Arbitrum or Polygon, and send the same request again with the payment in PAYMENT-SIGNATURE. The reply then carries PAYMENT-RESPONSE naming the transaction. One search of up to 10 results costs $0.007 ($0.002 with speed=fast, news or images), and a page read costs $0.002 for each page you ask for. The price is taken when the payment settles, before the call runs, so a search with no result or a page with no text is paid. If the call fails on our side after the payment settled, or the settle has no answer yet, send the same request with the same PAYMENT-SIGNATURE again: it is answered, and nothing is taken twice. Returns a JSON object with data.
Inputs
formatstring- Format for extract pages. One of: markdown, text, html.one of
markdowntexthtmldefaultmarkdown includearray- Include for extract pages.
pagesarray- Pages for extract pages.
urlsarray- Urls for extract pages.
x_end_user_cap_centsinteger- The most the end user named in X-End-User-Id may spend this UTC month, in cents. A call past it is refused with 402 and details.reason end_user_cap. Send it on each call; SpecStream stores no policy.
x_end_user_idstring- Your own label for the end user this call is for. SpecStream keeps only its SHA-256 hex, and GET /v1/account/usage?group=end_user sums your calls by it.
specstream_find_eventsSSE stream with Last-Event-ID.Read-onlyFind Events
SSE stream with Last-Event-ID. Needs id (identifiers returned by earlier SpecStream calls). The response is an event stream returned as text: the first lines show the events received before the connection closes.
Inputs
idstringrequired- ID for find events.
afterinteger- After for find events.
last_event_idstring- Optional value sent in the Last-Event-Id HTTP header.
specstream_get_accountPaid history.Read-onlyGet Account
Paid history. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_get_account_requestOpen one call of the request log, with its reply where it is kept.Read-onlyGet Account Request
Open one call of the request log, with its reply where it is kept. Returns a JSON object with data. Needs request_log_id (identifiers returned by earlier SpecStream calls).
Inputs
request_log_idstringrequired- Request Log ID for get account request.
specstream_get_account_usageSum calls and spend by day, endpoint, key or end user, for the Search API, the Extract API and Deep Search, as JSON or CSV.Read-onlyGet Account Usage
Sum calls and spend by day, endpoint, key or end user, for the Search API, the Extract API and Deep Search, as JSON or CSV. Returns a JSON object with data.
Inputs
formatstring- csv returns text/csv, one line per group value and product. One of: json, csv.one of
jsoncsvdefaultjson fromstring- An ISO date or time, UTC when no zone is given.
groupstring- end_user sums by the SHA-256 hex of each call's X-End-User-Id. One of: day, endpoint, key, end_user.one of
dayendpointkeyend_userdefaultday tostring- An ISO date or time, not included; a date alone includes that day.
specstream_get_agent_list_purchaseRead a purchased list and its rows.Read-onlyGet Agent List Purchase
Read a purchased list and its rows. Returns a JSON object with purchase_id, status, request, reading, requested, found, and more. Needs purchase_id (identifiers returned by earlier SpecStream calls).
Inputs
purchase_idstringrequired- The purchase_id from the 202.
specstream_get_browser_sessionRead a browser session: its status, why it ended, its seconds, actions, bytes and charge.Read-onlyGet Browser Session
Read a browser session: its status, why it ended, its seconds, actions, bytes and charge. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get browser session.
specstream_get_capacity_auto_topupRead the automatic top-up setting, its saved card, this month's charges and the allowed ranges.Read-onlyGet Capacity Auto Topup
Read the automatic top-up setting, its saved card, this month's charges and the allowed ranges. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_get_capacity_balanceRead the available balance without approving new work.Read-onlyGet Capacity Balance
Read the available balance without approving new work. Returns a JSON object with data.
Inputs
project_idstring- Project ID for get capacity balance.
specstream_get_capacity_catalogRead the current dollar balance and membership offer.Read-onlyGet Capacity Catalog
Read the current dollar balance and membership offer. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_get_capacity_entitlementsRead what the account's plan includes and how many members it uses.Read-onlyGet Capacity Entitlements
Read what the account's plan includes and how many members it uses. Returns a JSON object with data.
Inputs
project_idstring- Project ID for get capacity entitlements.
specstream_get_capacity_executionRead a find's approved work, final charge and your access to its results.Read-onlyGet Capacity Execution
Read a find's approved work, final charge and your access to its results. Returns a JSON object with data. Needs find_id (identifiers returned by earlier SpecStream calls).
Inputs
find_idstringrequired- Find ID for get capacity execution.
specstream_get_capacity_fundingRecover the original funding request from verified provider facts.Read-onlyGet Capacity Funding
Recover the original funding request from verified provider facts. Returns a JSON object with data. Needs funding_id (identifiers returned by earlier SpecStream calls).
Inputs
funding_idstringrequired- Funding ID for get capacity funding.
specstream_get_capacity_historyRead account balance events including the reason for each bonus grant.Read-onlyGet Capacity History
Read account balance events including the reason for each bonus grant. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_get_capacity_membershipRead the current paid period and next-renewal choice.Read-onlyGet Capacity Membership
Read the current paid period and next-renewal choice. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_get_capacity_partnerRead a partner's own link, terms and monthly sign-ups, payments and commission.Read-onlyGet Capacity Partner
Read a partner's own link, terms and monthly sign-ups, payments and commission. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_get_capacity_payment_receiptRead one payment's receipt: paid, tax, credit added with any prepayment bonus, refunds and the cash value of the credit left; an app store payment answers 409 receipt_issued_by_store.Read-onlyGet Capacity Payment Receipt
Read one payment's receipt: paid, tax, credit added with any prepayment bonus, refunds and the cash value of the credit left; an app store payment answers 409 receipt_issued_by_store. Returns a JSON object with data. Needs payment_id (identifiers returned by earlier SpecStream calls).
Inputs
payment_idstringrequired- Payment ID for get capacity payment receipt.
specstream_get_capacity_quoteRecover your signed quote and any find already approved from it.Read-onlyGet Capacity Quote
Recover your signed quote and any find already approved from it. Returns a JSON object with data. Needs quote_id (identifiers returned by earlier SpecStream calls).
Inputs
quote_idstringrequired- Quote ID for get capacity quote.
specstream_get_capacity_referralRead the verified account's stable referral link and rewards.Read-onlyGet Capacity Referral
Read the verified account's stable referral link and rewards. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_get_capacity_refund_claimRead the status of an owned correction claim.Read-onlyGet Capacity Refund Claim
Read the status of an owned correction claim. Returns a JSON object with data. Needs claim_id (identifiers returned by earlier SpecStream calls).
Inputs
claim_idstringrequired- Claim ID for get capacity refund claim.
specstream_get_capacity_requestRecover the find already started with this request key.Read-onlyGet Capacity Request
Recover the find already started with this request key. Returns a JSON object with data. Needs request_key (identifiers returned by earlier SpecStream calls).
Inputs
request_keystringrequired- Request Key for get capacity request.
project_idstring- Project ID for get capacity request.
specstream_get_capacity_request_rowsRead where the request asked with this key stands and the rows it found so far.Read-onlyGet Capacity Request Rows
Read where the request asked with this key stands and the rows it found so far. Returns a JSON object with data. Needs request_key (identifiers returned by earlier SpecStream calls).
Inputs
request_keystringrequired- Request Key for get capacity request rows.
cursorstring- Cursor for get capacity request rows.
formatstring- json returns the records. markdown or csv returns the asked columns in order as one table in data.table, with a source link for each value, in place of the records. One of: json, markdown, csv.one of
jsonmarkdowncsvdefaultjson limitinteger- Limit for get capacity request rows.default
100 project_idstring- Project ID for get capacity request rows.
specstream_get_capacity_store_configRead the app store products and this account's store purchases.Read-onlyGet Capacity Store Config
Read the app store products and this account's store purchases. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_get_connection_columnsRead destination columns before mapping fields.Read-onlyGet Connection Columns
Read destination columns before mapping fields. Returns a JSON object with data. Needs identity (identifiers returned by earlier SpecStream calls).
Inputs
identitystringrequired- Identity for get connection columns.
selectionobjectrequired- Selection for get connection columns.
specstream_get_crawlRead a crawl job: its state and its pages from skip; follow next_skip.Read-onlyGet Crawl
Read a crawl job: its state and its pages from skip; follow next_skip. Returns a JSON object with data. Needs crawl_id (identifiers returned by earlier SpecStream calls).
Inputs
crawl_idstringrequired- Crawl ID for get crawl.
skipinteger- The first page of results to return, as next_skip names it.default
0
specstream_get_deliveryRead your finished results with the request revision and sources behind them.Read-onlyGet Delivery
Read your finished results with the request revision and sources behind them. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get delivery.
specstream_get_findOwner find snapshot.Read-onlyGet Find
Owner find snapshot. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get find.
specstream_get_find_commerceRead payment, fulfillment and access truth.Read-onlyGet Find Commerce
Read payment, fulfillment and access truth. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get find commerce.
specstream_get_find_decisionsRead currently authorized Match decisions.Read-onlyGet Find Decisions
Read currently authorized Match decisions. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get find decisions.
cursorstring- Cursor for get find decisions.
limitinteger- Limit for get find decisions.default
100
specstream_get_find_lineageRead which request revision a find ran, and the find it continued.Read-onlyGet Find Lineage
Read which request revision a find ran, and the find it continued. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get find lineage.
specstream_get_find_rowsRead the delivered results and the source behind each condition.Read-onlyGet Find Rows
Read the delivered results and the source behind each condition. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get find rows.
cursorstring- Cursor for get find rows.
formatstring- json returns the records. markdown or csv returns the asked columns in order as one table in data.table, with a source link for each value, in place of the records. One of: json, markdown, csv.one of
jsonmarkdowncsvdefaultjson limitinteger- Limit for get find rows.default
100
specstream_get_investigation_batchRead each input row, its search status and the list it led to.Read-onlyGet Investigation Batch
Read each input row, its search status and the list it led to. Returns a JSON object with data. Needs batch_id (identifiers returned by earlier SpecStream calls).
Inputs
batch_idstringrequired- Batch ID for get investigation batch.
specstream_get_investigation_functionRead the saved request and its typed inputs.Read-onlyGet Investigation Function
Read the saved request and its typed inputs. Returns a JSON object with data. Needs function_id (identifiers returned by earlier SpecStream calls).
Inputs
function_idstringrequired- Function ID for get investigation function.
specstream_get_investigation_inputsList the columns of a list with example values, to choose which column feeds each input.Read-onlyGet Investigation Inputs
List the columns of a list with example values, to choose which column feeds each input. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for get investigation inputs.
specstream_get_investigation_parametersList the values in a saved request that can become inputs.Read-onlyGet Investigation Parameters
List the values in a saved request that can become inputs. Returns a JSON object with data. Needs spec_id (identifiers returned by earlier SpecStream calls).
Inputs
spec_idstringrequired- Spec ID for get investigation parameters.
revision_idstring- Revision ID for get investigation parameters.
specstream_get_investigation_resultsRead each input row with the results it led to, including their sources.Read-onlyGet Investigation Results
Read each input row with the results it led to, including their sources. Input values are never treated as sources for results. Returns a JSON object with data. Needs batch_id (identifiers returned by earlier SpecStream calls).
Inputs
batch_idstringrequired- Batch ID for get investigation results.
specstream_get_meSpend ceiling and remaining_spend authorization state.Read-onlyGet Me
Spend ceiling and remaining_spend authorization state. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_get_projectRead current project membership and authorization.Read-onlyGet Project
Read current project membership and authorization. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get project.
specstream_get_reconciled_inputRead which chosen pair filled each cell of a list made by matching.Read-onlyGet Reconciled Input
Read which chosen pair filled each cell of a list made by matching. Returns a JSON object with data. Needs import_id (identifiers returned by earlier SpecStream calls).
Inputs
import_idstringrequired- Import ID for get reconciled input.
specstream_get_reconciliationRead a comparison: proposed pairs, alternatives, conflicts, missing values and sources.Read-onlyGet Reconciliation
Read a comparison: proposed pairs, alternatives, conflicts, missing values and sources. Returns a JSON object with data. Needs comparison_id (identifiers returned by earlier SpecStream calls).
Inputs
comparison_idstringrequired- Comparison ID for get reconciliation.
specstream_get_reconciliation_fieldsRead the fields of a list you can open that can be used to match it against another list.Read-onlyGet Reconciliation Fields
Read the fields of a list you can open that can be used to match it against another list. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for get reconciliation fields.
specstream_get_researchRead a research run: its state and progress, and its report when it is completed.Read-onlyGet Research
Read a research run: its state and progress, and its report when it is completed. Returns a JSON object with data. Needs run_id (identifiers returned by earlier SpecStream calls).
Inputs
run_idstringrequired- Run ID for get research.
specstream_get_research_ruleRead a rule's limits, what it has spent, which rows are waiting and its recent runs.Read-onlyGet Research Rule
Read a rule's limits, what it has spent, which rows are waiting and its recent runs. Returns a JSON object with data. Needs rule_id (identifiers returned by earlier SpecStream calls).
Inputs
rule_idstringrequired- Rule ID for get research rule.
offsetinteger- Offset for get research rule.default
0
specstream_get_research_rule_resultsRead every run of the rule with its input rows and results.Read-onlyGet Research Rule Results
Read every run of the rule with its input rows and results. Returns a JSON object with data. Needs rule_id (identifiers returned by earlier SpecStream calls).
Inputs
rule_idstringrequired- Rule ID for get research rule results.
specstream_get_revisit_reportRead which saved results a refresh reached, and which it did not.Read-onlyGet Revisit Report
Read which saved results a refresh reached, and which it did not. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get revisit report.
afterstring- After for get revisit report.default
limitinteger- Limit for get revisit report.default
100
specstream_get_specRead a saved request and its current revision.Read-onlyGet Spec
Read a saved request and its current revision. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get spec.
specstream_get_spec_optionsRead the conditions and details you can ask for on one record type.Read-onlyGet Spec Options
Read the conditions and details you can ask for on one record type. Returns a JSON object with data.
Inputs
targetstringrequired- Target for get spec options.
specstream_get_spec_revisionRead one revision of a saved request.Read-onlyGet Spec Revision
Read one revision of a saved request. Returns a JSON object with data. Needs id, revision_id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for get spec revision.
revision_idstringrequired- Revision ID for get spec revision.
specstream_get_vocabularyRead the public bar vocabulary and ready-made details.Read-onlyGet Vocabulary
Read the public bar vocabulary and ready-made details. Returns a JSON object with data.
Inputs
if_none_matchstring- Optional value sent in the If-None-Match HTTP header.
specstream_get_web_sourceRead a saved website source and how each of its columns is read.Read-onlyGet Web Source
Read a saved website source and how each of its columns is read. Returns a JSON object with data. Needs source_id (identifiers returned by earlier SpecStream calls).
Inputs
source_idstringrequired- Source ID for get web source.
specstream_get_web_source_previewRead one source preview with its page hash, cell locations and field explanations.Read-onlyGet Web Source Preview
Read one source preview with its page hash, cell locations and field explanations. Returns a JSON object with data. Needs preview_id (identifiers returned by earlier SpecStream calls).
Inputs
preview_idstringrequired- Preview ID for get web source preview.
specstream_list_account_keysList API keys.Read-onlyList Account Keys
List API keys. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_account_requestsList the account's Search API and Extract API calls, charged or not, newest first.Read-onlyList Account Requests
List the account's Search API and Extract API calls, charged or not, newest first. Returns a JSON object with data.
Inputs
cursorstring- Cursor for list account requests.
endpointstring- Endpoint for list account requests. One of: /v1/web-search, /v1/web-search/batch, /v1/extract.one of
/v1/web-search/v1/web-search/batch/v1/extract fromstring- An ISO date or time, UTC when no zone is given.
key_idstring- Key ID for list account requests.
limitinteger- Limit for list account requests.default
50 statusstring- One status, such as 429, or a class, such as 4xx.
tostring- An ISO date or time, not included; a date alone includes that day.
specstream_list_browser_sessionsList the account's browser sessions, newest first.Read-onlyList Browser Sessions
List the account's browser sessions, newest first. Returns a JSON object with data.
Inputs
cursorstring- Cursor for list browser sessions.
limitinteger- Limit for list browser sessions.default
20 statusstring- Status for list browser sessions. One of: starting, running, ended.one of
startingrunningended
specstream_list_capacity_occurrencesRead completed, blocked, and missed occurrences.Read-onlyList Capacity Occurrences
Read completed, blocked, and missed occurrences. Returns a JSON object with data. Needs schedule_id (identifiers returned by earlier SpecStream calls).
Inputs
schedule_idstringrequired- Schedule ID for list capacity occurrences.
beforestring- Before for list capacity occurrences.
limitinteger- Limit for list capacity occurrences.default
50
specstream_list_capacity_paymentsList the account's payments as receipts, newest first; app store payments are counted, not listed, since the store issues their receipts.Read-onlyList Capacity Payments
List the account's payments as receipts, newest first; app store payments are counted, not listed, since the store issues their receipts. Returns a JSON object with data.
Inputs
cursorstring- Cursor for list capacity payments.
limitinteger- Limit for list capacity payments.default
50
specstream_list_capacity_refund_claimsRead the account's correction claims, newest first.Read-onlyList Capacity Refund Claims
Read the account's correction claims, newest first. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_capacity_schedulesRead authorized recurring work and its current state.Read-onlyList Capacity Schedules
Read authorized recurring work and its current state. Returns a JSON object with data.
Inputs
afterstring- After for list capacity schedules.default
limitinteger- Limit for list capacity schedules.default
50 project_idstring- Project ID for list capacity schedules.
specstream_list_cloud_importsList daily source checks and import status.Read-onlyList Cloud Imports
List daily source checks and import status. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_collection_investigationsList the recent runs started from this list.Read-onlyList Collection Investigations
List the recent runs started from this list. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for list collection investigations.
specstream_list_connected_toolsList supported tables, CRM, automation and chat tools.Read-onlyList Connected Tools
List supported tables, CRM, automation and chat tools. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_connection_destinationsList provider-authorized destinations.Read-onlyList Connection Destinations
List provider-authorized destinations. Returns a JSON object with data. Needs identity (identifiers returned by earlier SpecStream calls).
Inputs
identitystringrequired- Identity for list connection destinations.
base_idstring- Base ID for list connection destinations.
cursorstring- Cursor for list connection destinations.
specstream_list_connectionsList this account's connected providers.Read-onlyList Connections
List this account's connected providers. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_customer_webhooksList owned callback destinations without secrets.Read-onlyList Customer Webhooks
List owned callback destinations without secrets. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_destination_exportsList delivery receipts for connected tools.Read-onlyList Destination Exports
List delivery receipts for connected tools. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_destination_syncsList continuous destination deliveries.Read-onlyList Destination Syncs
List continuous destination deliveries. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_investigation_functionsList the saved requests in this project that can run once per row.Read-onlyList Investigation Functions
List the saved requests in this project that can run once per row. Returns a JSON object with data.
Inputs
project_idstring- Project ID for list investigation functions.
specstream_list_project_membersList current project membership.Read-onlyList Project Members
List current project membership. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for list project members.
cursorstring- Cursor for list project members.
limitinteger- Limit for list project members.default
50
specstream_list_projectsList currently authorized projects.Read-onlyList Projects
List currently authorized projects. Returns a JSON object with data.
Inputs
cursorstring- Cursor for list projects.
limitinteger- Limit for list projects.default
50
specstream_list_reconciliationsList the recent comparisons that include this list (the latest 20, kept for 30 days).Read-onlyList Reconciliations
List the recent comparisons that include this list (the latest 20, kept for 30 days). Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for list reconciliations.
specstream_list_request_templatesList request examples; compile and quote before work.Read-onlyList Request Templates
List request examples; compile and quote before work. Returns a JSON object with data.
Inputs
record_typestring- Record Type for list request templates.
specstream_list_researchList your research runs, newest first; follow next_after.Read-onlyList Research
List your research runs, newest first; follow next_after. Returns a JSON object with data.
Inputs
afterstring- The run id next_after named: the page after it.
limitinteger- Limit for list research.default
20
specstream_list_research_rulesList the automatic research rules on this list.Read-onlyList Research Rules
List the automatic research rules on this list. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for list research rules.
specstream_list_search_dialectsList the other search and page APIs SpecStream answers in, each with the addresses to paste and a curl call; no key needed.Read-onlyList Search Dialects
List the other search and page APIs SpecStream answers in, each with the addresses to paste and a curl call; no key needed. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_search_enginesList the web search engines a Search API call may ask, each with who runs it and the country it is run from, for a key's engine_rule and a call's engines parameter; no key needed.Read-onlyList Search Engines
List the web search engines a Search API call may ask, each with who runs it and the country it is run from, for a key's engine_rule and a call's engines parameter; no key needed. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_list_spec_findsRead the finds a saved request has run.Read-onlyList Spec Finds
Read the finds a saved request has run. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for list spec finds.
cursorstring- Cursor for list spec finds.
limitinteger- Limit for list spec finds.default
50
specstream_list_spec_revisionsRead a saved request's revision history.Read-onlyList Spec Revisions
Read a saved request's revision history. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for list spec revisions.
cursorstring- Cursor for list spec revisions.
limitinteger- Limit for list spec revisions.default
50
specstream_list_specsList the saved requests you can open.Read-onlyList Specs
List the saved requests you can open. Returns a JSON object with data.
Inputs
archivedboolean- Archived for list specs.default
false cursorstring- Cursor for list specs.
limitinteger- Limit for list specs.default
50 project_idstring- Project ID for list specs.
specstream_list_web_sourcesList up to 100 saved website sources in a project.Read-onlyList Web Sources
List up to 100 saved website sources in a project. No page is read. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_map_siteMap a site: its start page's links and its sitemaps' pages, kept to the site.Read-onlyMap Site
Map a site: its start page's links and its sitemaps' pages, kept to the site. One page read when it gives a link. Returns a JSON object with data.
Inputs
urlstringrequired- URL for map site.
idempotency_keystring- Your id for this call, at most 128 characters. The same id again answers with the same map charge or the same crawl job.
include_subdomainsboolean- Include Subdomains for map site.default
false limitinteger- Limit for map site.default
5000 sitemapstring- Sitemap for map site. One of: include, skip, only.one of
includeskiponlydefaultinclude
specstream_parse_from_chipsEdit the reading with typed changes, without a model call.Read-onlyParse From Chips
Edit the reading with typed changes, without a model call. Returns a JSON object with data.
Inputs
astobjectrequired- Ast for parse from chips.
operationsarrayrequired- Operations for parse from chips.
specstream_parse_queryRead a request in plain words and return an editable reading.Read-onlyParse Query
Read a request in plain words and return an editable reading. Returns a JSON object with data.
Inputs
qstringrequired- Q for parse query.
expected_source_hashstring- Expected Source Hash for parse query.
kindstring- Chosen result kind; the compiler never switches away from it.
localestring- Locale for parse query.default
en-US named_phrasesarray- Phrases the caller knows are one name each (a page's own subject, a product line with commas in it). Each is read as one name wherever it appears in q; a phrase that does not appear in q is ignored.
retainedobject- An explicit dependency on an authorized, immutable prior research request. The label is display text only. It never selects records or changes the target. The server loads the actual Spec; callers cannot provide a replacement base.
specstream_preview_cloud_listRead a provider-authorized list before importing.Read-onlyPreview Cloud List
Read a provider-authorized list before importing. Returns a JSON object with data.
Inputs
connection_idstringrequired- Connection ID for preview cloud list.
linkstringrequired- Link for preview cloud list.
sheet_idstring- Sheet ID for preview cloud list.
specstream_preview_web_sourceRead the saved page again and preview its rows.Read-onlyPreview Web Source
Read the saved page again and preview its rows. Earlier lists stay unchanged. Columns paired by position need fresh examples once the page changes. Returns a JSON object with data. Needs source_id (identifiers returned by earlier SpecStream calls).
Inputs
source_idstringrequired- Source ID for preview web source.
specstream_quote_capacity_workGet a quote for a request before anything runs.Read-onlyQuote Capacity Work
Get a quote for a request before anything runs. Returns a JSON object with data.
Inputs
ast_hashstringrequired- Ast Hash for quote capacity work.
minimum_unitsinteger- Minimum Units for quote capacity work.
operationstring- Operation for quote capacity work. One of: find, extend, add_facts, refresh, retained.one of
findextendadd_factsrefreshretaineddefaultfind parent_find_idstring- Parent Find ID for quote capacity work.
project_idstring- Project ID for quote capacity work.
requested_unitsinteger- Requested Units for quote capacity work.default
25 revision_idstring- Revision ID for quote capacity work.
selected_entity_idsarray- Selected Entity IDS for quote capacity work.
source_import_idstring- Source Import ID for quote capacity work.
source_row_idsarray- Source Row IDS for quote capacity work.
specstream_replay_find_decisionsReplay saved match decisions from their saved sources, with no new source or model calls.Read-onlyReplay Find Decisions
Replay saved match decisions from their saved sources, with no new source or model calls. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for replay find decisions.
specstream_research_eventsA research run's events as a server-sent stream, to its end; Last-Event-ID resumes it.Read-onlyResearch Events
A research run's events as a server-sent stream, to its end; Last-Event-ID resumes it. Needs run_id (identifiers returned by earlier SpecStream calls). The response is an event stream returned as text: the first lines show the events received before the connection closes.
Inputs
run_idstringrequired- Run ID for research events.
afterinteger- Send the events after this event id (as Last-Event-ID does).
last_event_idstring- Optional value sent in the Last-Event-Id HTTP header.
specstream_teach_web_sourceRead one public page and learn its records and fields from 3 to 8 example rows.Read-onlyTeach Web Source
Read one public page and learn its records and fields from 3 to 8 example rows. The preview explains how each field was inferred and marks the example rows. Nothing becomes a list until you save it. Returns a JSON object with data.
Inputs
examplesarrayrequired- Examples for teach web source.
namestringrequired- Name for teach web source.
urlstringrequired- URL for teach web source.
excludearray- Exclude for teach web source.
name_columnstring- Name Column for teach web source.default
name project_idstring- Project ID for teach web source.
specstream_understand_liveRead an exact editor snapshot without saving or authorizing work.Read-onlyUnderstand Live
Read an exact editor snapshot without saving or authorizing work. Returns a JSON object with data.
Inputs
document_idstringrequired- Document ID for understand live.
revisionintegerrequired- Revision for understand live.
textstringrequired- Text for understand live.
contextobject- Workspace hints. They never widen the request. The quote holds the context of the run.
expected_source_hashstring- Expected Source Hash for understand live.
generationinteger- Generation for understand live.default
0 kindstring- Chosen result kind; shared by fast and refined readings.
phasestring- Phase for understand live. One of: fast, refined.one of
fastrefineddefaultfast
specstream_web_searchSearch API: answer a question from the live web in seconds, each value with its source.Read-onlyWeb Search
Search API: answer a question from the live web in seconds, each value with its source. With no API key, the call answers 402 with a PAYMENT-REQUIRED header (base64 x402 v2 PaymentRequired): pay for this one call with x402's `exact` scheme in USDC on Base, Arbitrum or Polygon, and send the same request again with the payment in PAYMENT-SIGNATURE. The reply then carries PAYMENT-RESPONSE naming the transaction. One search of up to 10 results costs $0.007 ($0.002 with speed=fast, news or images), and a page read costs $0.002 for each page you ask for. The price is taken when the payment settles, before the call runs, so a search with no result or a page with no text is paid. If the call fails on our side after the payment settled, or the settle has no answer yet, send the same request with the same PAYMENT-SIGNATURE again: it is answered, and nothing is taken twice. Returns a JSON object with data.
Inputs
qstringrequired- The question or the request in everyday words, in any language. Search operators hold on every result: site:, -site:, -word, -"phrase", "phrase", filetype:, after: and before: (YYYY, YYYY-MM or YYYY-MM-DD). A result that breaks one is left out; when that leaves a page short, the engines' next pages are searched first.
countrystring- The country the results are for, as a two-letter ISO 3166-1 code (DE). Sent to every search engine that takes a country.
enginesstring- Narrows the engines this call may ask, never past the key's own engine_rule: engine names and two-letter ISO 3166-1 country codes of their operators, comma-separated. A leading - denies one (-CN asks no engine run from China); names without - are the only ones asked (bing,duckduckgo). The engines are listed at /v1/search-engines.
engines_askedboolean- Name the engines the query was sent to in the reply (engines_asked).default
false idempotency_keystring- Your id for this call, at most 128 characters. A call is charged once per id, and the same id again is refused with 409. Without one, SpecStream gives the call an id and returns it as request_id.
languagestring- The language of the results, as a two-letter ISO 639-1 code (de). Sent to every search engine that takes a language.
newsboolean- News items for the query instead of web results: newest first, each with its publisher (source), its day (published) and its time (published_at). A fast search at the same price; not with passages.default
false numinteger- The number of results (sources) to return, 1 to 100, or 1 to 200 with images=true. Without num or page, the reply holds every result the answer read. When the first search finds fewer, SpecStream searches deeper (more engines and their next result pages) before it answers. A call of up to 10 results is $0.005; each started block of 10 more results adds $0.006 (100 results are $0.059). On the fast tier (speed=fast) a call of up to 10 results is $0.001 and each started block of 10 more adds $0.0012 (100 results are $0.0118). An image search (images=true) always runs the fast tier, so 200 images are $0.0238. A call is charged for the results it returns; a call that returns none costs nothing.
pageinteger- The page of results to return, 1 to 10, num results each (10 without num). Page 2 continues the same list as page 1. The answer and the rows are on page 1 only. next_page in the reply names the next page, or is null when the engines found no more.
pages_wait_msinteger- With passages=true: how long, in milliseconds, the call waits for the pages' text. The first five sources wait for theirs; the rest keep what is in by then, and pages_pending names the sources still being read. Absent: the call waits for every source's text, as before.
passagesboolean- Also return the text of the top pages closest to the request, each with its page, so a caller sees the evidence without reading a page.default
false safestring- The safe search level: off, moderate or strict. Sent to every search engine that takes one; without it each engine uses its own default. One of: off, moderate, strict.one of
offmoderatestrict speedstring- fast gives the search results in about a second: the first engines' results with their snippets, each with the time it was read (read_at), with no answer, rows or passages; num and page past the first 10 results come from the engines' own later pages. default also reads the results for the answer and its rows. A fast call of up to 10 results is $0.001 ($1 per 1,000), a default call $0.005 ($5 per 1,000). One of: default, fast.one of
defaultfastdefaultdefault x_end_user_cap_centsinteger- The most the end user named in X-End-User-Id may spend this UTC month, in cents. A call past it is refused with 402 and details.reason end_user_cap. Send it on each call; SpecStream stores no policy.
x_end_user_idstring- Your own label for the end user this call is for. SpecStream keeps only its SHA-256 hex, and GET /v1/account/usage?group=end_user sums your calls by it.
specstream_web_search_answerOpen one kept web search answer as it was given.Read-onlyWeb Search Answer
Open one kept web search answer as it was given. Returns a JSON object with data. Needs answer_id (identifiers returned by earlier SpecStream calls).
Inputs
answer_idstringrequired- Answer ID for web search answer.
specstream_web_search_answersList your web search history: each question, its answer and its sources, newest first.Read-onlyWeb Search Answers
List your web search history: each question, its answer and its sources, newest first. Returns a JSON object with data.
Inputs
cursorstring- Cursor for web search answers.
limitinteger- Limit for web search answers.default
20 qstring- Searches whose words contain this text, in any case.
specstream_web_search_batchSearch API for many questions in one call, each answered and billed as one web search.Read-onlyWeb Search Batch
Search API for many questions in one call, each answered and billed as one web search. Returns a JSON object with data.
Inputs
questionsarrayrequired- Questions for web search batch.
x_end_user_cap_centsinteger- The most the end user named in X-End-User-Id may spend this UTC month, in cents. A call past it is refused with 402 and details.reason end_user_cap. Send it on each call; SpecStream stores no policy.
x_end_user_idstring- Your own label for the end user this call is for. SpecStream keeps only its SHA-256 hex, and GET /v1/account/usage?group=end_user sums your calls by it.
specstream_web_search_postSearch API with the question in a JSON body: the GET's parameters, same names, defaults, price and reply, so no address and no log of one holds the question's words.Read-onlyWeb Search Post
Search API with the question in a JSON body: the GET's parameters, same names, defaults, price and reply, so no address and no log of one holds the question's words. A parameter sent in both the address and the body is refused. With no API key, the call answers 402 with a PAYMENT-REQUIRED header (base64 x402 v2 PaymentRequired): pay for this one call with x402's `exact` scheme in USDC on Base, Arbitrum or Polygon, and send the same request again with the payment in PAYMENT-SIGNATURE. The reply then carries PAYMENT-RESPONSE naming the transaction. One search of up to 10 results costs $0.007 ($0.002 with speed=fast, news or images), and a page read costs $0.002 for each page you ask for. The price is taken when the payment settles, before the call runs, so a search with no result or a page with no text is paid. If the call fails on our side after the payment settled, or the settle has no answer yet, send the same request with the same PAYMENT-SIGNATURE again: it is answered, and nothing is taken twice. Returns a JSON object with data.
Inputs
qstringrequired- Q for web search post.
countrystring- Country for web search post.
enginesstring- Engines for web search post.
engines_askedboolean- Engines Asked for web search post.default
false idempotency_keystring- Your id for this call, at most 128 characters. A call is charged once per id, and the same id again is refused with 409. Without one, SpecStream gives the call an id and returns it as request_id.
image_aspectstring- Image Aspect for web search post.
image_colorstring- Image Color for web search post.
image_sizestring- Image Size for web search post.
image_typestring- Image Type for web search post.
imagesboolean- Images for web search post.default
false languagestring- Language for web search post.
max_heightinteger- Max Height for web search post.
max_widthinteger- Max Width for web search post.
min_heightinteger- Min Height for web search post.
min_widthinteger- Min Width for web search post.
newsboolean- News for web search post.default
false numinteger- Num for web search post.
pageinteger- Page for web search post.
pages_wait_msinteger- Pages Wait Ms for web search post.
passagesboolean- Passages for web search post.default
false safestring- Safe for web search post.
speedstring- Speed for web search post.default
default x_end_user_cap_centsinteger- The most the end user named in X-End-User-Id may spend this UTC month, in cents. A call past it is refused with 402 and details.reason end_user_cap. Send it on each call; SpecStream stores no policy.
x_end_user_idstring- Your own label for the end user this call is for. SpecStream keeps only its SHA-256 hex, and GET /v1/account/usage?group=end_user sums your calls by it.
specstream_workspace_activityRead activity through current account and project permissions.Read-onlyWorkspace Activity
Read activity through current account and project permissions. Returns a JSON object with data.
Inputs
cursorstring- Cursor for workspace activity.
limitinteger- Limit for workspace activity.default
50 project_idstring- Project ID for workspace activity.
specstream_workspace_collection_changesRead source-backed changes against immutable prior results.Read-onlyWorkspace Collection Changes
Read source-backed changes against immutable prior results. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for workspace collection changes.
specstream_workspace_export_audit_eventsExport an authorized activity page; follow X-Next-Cursor.Read-onlyWorkspace Export Audit Events
Export an authorized activity page; follow X-Next-Cursor.
Inputs
actor_account_idstring- Actor Account ID for workspace export audit events.
cursorstring- Cursor for workspace export audit events.
kindstring- Kind for workspace export audit events. One of: Sign-in, Access, Spending, Exports, Automation, Lists.one of
Sign-inAccessSpendingExportsAutomationLists limitinteger- Limit for workspace export audit events.default
100 project_idstring- Project ID for workspace export audit events.
specstream_workspace_export_collectionExport a full collection with current scoped access and suppression.Read-onlyWorkspace Export Collection
Export a full collection with current scoped access and suppression. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for workspace export collection.
formatstring- Format for workspace export collection. One of: csv, xlsx, json, html, kml, geojson.one of
csvxlsxjsonhtmlkmlgeojsondefaultcsv
specstream_workspace_filter_collectionFilter a list's rows by IDs, sources or a map area.Read-onlyWorkspace Filter Collection
Filter a list's rows by IDs, sources or a map area. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for workspace filter collection.
bboxarray- Bbox for workspace filter collection.
record_idsarray- Record IDS for workspace filter collection.
source_collection_idsarray- Source Collection IDS for workspace filter collection.
specstream_workspace_launch_native_providerLaunch the browser-bound provider handoff.Read-onlyWorkspace Launch Native Provider
Launch the browser-bound provider handoff.
Inputs
ticketstringrequired- Ticket for workspace launch native provider.
specstream_workspace_list_audit_eventsRead immutable twelve-month activity with current owner permissions.Read-onlyWorkspace List Audit Events
Read immutable twelve-month activity with current owner permissions. Returns a JSON object with data.
Inputs
actor_account_idstring- Actor Account ID for workspace list audit events.
cursorstring- Cursor for workspace list audit events.
kindstring- Kind for workspace list audit events. One of: Sign-in, Access, Spending, Exports, Automation, Lists.one of
Sign-inAccessSpendingExportsAutomationLists limitinteger- Limit for workspace list audit events.default
50 project_idstring- Project ID for workspace list audit events.
specstream_workspace_list_collectionsRead the lists you can open, from your finds and imports.Read-onlyWorkspace List Collections
Read the lists you can open, from your finds and imports. Returns a JSON object with data.
Inputs
afterstring- After for workspace list collections.
limitinteger- Limit for workspace list collections.default
50 project_idstring- Project ID for workspace list collections.
sortstring- Sort for workspace list collections. One of: id, recent.one of
idrecentdefaultid
specstream_workspace_list_notesRead authorized project or collection-record notes.Read-onlyWorkspace List Notes
Read authorized project or collection-record notes. Returns a JSON object with data.
Inputs
collection_idstring- Collection ID for workspace list notes.
project_idstring- Project ID for workspace list notes.
record_idstring- Record ID for workspace list notes.
specstream_workspace_list_notificationsRead your inbox with current resource authorization.Read-onlyWorkspace List Notifications
Read your inbox with current resource authorization. Returns a JSON object with data.
Inputs
cursorstring- Cursor for workspace list notifications.
limitinteger- Limit for workspace list notifications.default
50 tabstring- Tab for workspace list notifications. One of: all, unread, archived.one of
allunreadarchiveddefaultall
specstream_workspace_list_passkeysList the current account's registered passkeys.Read-onlyWorkspace List Passkeys
List the current account's registered passkeys. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_workspace_list_push_devicesList your registered notification devices.Read-onlyWorkspace List Push Devices
List your registered notification devices. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_workspace_list_sso_domainsList account-owned verified SSO domains.Read-onlyWorkspace List SSO Domains
List account-owned verified SSO domains. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_workspace_list_starsList starred work that remains currently authorized.Read-onlyWorkspace List Stars
List starred work that remains currently authorized. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_workspace_list_viewsList your saved views of a list.Read-onlyWorkspace List Views
List your saved views of a list. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for workspace list views.
specstream_workspace_list_your_fieldsRead the fields you added to a collection and their values.Read-onlyWorkspace List Your Fields
Read the fields you added to a collection and their values. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for workspace list your fields.
specstream_workspace_placement_allowanceRead this billing account's UTC monthly free placement allowance.Read-onlyWorkspace Placement Allowance
Read this billing account's UTC monthly free placement allowance. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_workspace_placement_statusRead placement progress and per-row geocoding outcomes.Read-onlyWorkspace Placement Status
Read placement progress and per-row geocoding outcomes. Returns a JSON object with data. Needs import_id, placement_id (identifiers returned by earlier SpecStream calls).
Inputs
import_idstringrequired- Import ID for workspace placement status.
placement_idstringrequired- Placement ID for workspace placement status.
specstream_workspace_push_capabilitiesRead configured notification transports, never credentials.Read-onlyWorkspace Push Capabilities
Read configured notification transports, never credentials. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_workspace_quote_placementQuote the maximum cost of placing imported addresses on the map.Read-onlyWorkspace Quote Placement
Quote the maximum cost of placing imported addresses on the map. Returns a JSON object with data. Needs import_id (identifiers returned by earlier SpecStream calls).
Inputs
import_idstringrequired- Import ID for workspace quote placement.
specstream_workspace_read_collectionRead one list, without rows removed by an opt-out.Read-onlyWorkspace Read Collection
Read one list, without rows removed by an opt-out. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for workspace read collection.
specstream_workspace_read_photoRead the account-owned photo version and private URL.Read-onlyWorkspace Read Photo
Read the account-owned photo version and private URL. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_workspace_read_scim_mappingsRead provisioning mappings, provider groups and token state.Read-onlyWorkspace Read SCIM Mappings
Read provisioning mappings, provider groups and token state. Returns a JSON object with data. Needs domain_id (identifiers returned by earlier SpecStream calls).
Inputs
domain_idstringrequired- Domain ID for workspace read scim mappings.
specstream_workspace_relationshipsGroup accessible records by actual shared column values.Read-onlyWorkspace Relationships
Group accessible records by actual shared column values. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for workspace relationships.
field_idstring- Field ID for workspace relationships.
specstream_workspace_research_inputReview each imported row: which business it matched and why, other possible matches, and its result.Read-onlyWorkspace Research Input
Review each imported row: which business it matched and why, other possible matches, and its result. Returns a JSON object with data. Needs find_id (identifiers returned by earlier SpecStream calls).
Inputs
find_idstringrequired- Find ID for workspace research input.
specstream_workspace_searchSearch the requests, lists and sources you can open.Read-onlyWorkspace Search
Search the requests, lists and sources you can open. Returns a JSON object with data.
Inputs
qstringrequired- Q for workspace search.
cursorstring- Cursor for workspace search.
limitinteger- Limit for workspace search.default
30
specstream_apply_reconciliationFill empty cells in a new list from the pairs you chose.WriteApply Reconciliation
Fill empty cells in a new list from the pairs you chose. The original lists stay unchanged. Returns a JSON object with data. Needs comparison_id (identifiers returned by earlier SpecStream calls).
Inputs
choicesarrayrequired- Choices for apply reconciliation.
comparison_hashstringrequired- Comparison Hash for apply reconciliation.
comparison_idstringrequired- Comparison ID for apply reconciliation.
import_idstringrequired- Import ID for apply reconciliation.
namestringrequired- Name for apply reconciliation.
specstream_approve_investigation_batchApprove the quote's exact maximum.WriteApprove Investigation Batch
Approve the quote's exact maximum. The searches then run as ordinary finds, within that maximum. Returns a JSON object with data. Needs batch_id (identifiers returned by earlier SpecStream calls).
Inputs
batch_idstringrequired- Batch ID for approve investigation batch.
confirm_max_centsintegerrequired- Confirm Max Cents for approve investigation batch.
quote_hashstringrequired- Quote Hash for approve investigation batch.
specstream_approve_research_ruleApprove the rule's total spending limit.WriteApprove Research Rule
Approve the rule's total spending limit. Rows that qualify later then run without asking again, until the limit or the expiry is reached. Returns a JSON object with data. Needs rule_id (identifiers returned by earlier SpecStream calls).
Inputs
confirm_total_centsintegerrequired- Confirm Total Cents for approve research rule.
review_hashstringrequired- Review Hash for approve research rule.
rule_idstringrequired- Rule ID for approve research rule.
specstream_archive_specArchive or restore a saved request.WriteArchive Spec
Archive or restore a saved request. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
expected_revision_idstringrequired- Expected Revision ID for archive spec.
idstringrequired- ID for archive spec.
archivedboolean- Archived for archive spec.default
true
specstream_browser_actionRun one step in the browser: a Playwright MCP tool by its name and arguments (navigate, snapshot, click, type, take a screenshot and the others), or browser_read for the page's text as Markdown.WriteBrowser Action
Run one step in the browser: a Playwright MCP tool by its name and arguments (navigate, snapshot, click, type, take a screenshot and the others), or browser_read for the page's text as Markdown. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for browser action.
toolstringrequired- A Playwright MCP tool name (browser_navigate, browser_snapshot, browser_click, browser_type, browser_take_screenshot and the others), or browser_read for the page's text.
argumentsobject- The tool's arguments, as Playwright MCP names them. browser_read takes format: markdown (default) or text.
specstream_buy_agent_listBuy a list from the live web, priced per result.WriteBuy Agent List
Buy a list from the live web, priced per result. Without a payment this answers 402 with the most the run can cost. Pay with MPP or x402 and send the same request again to start the run. Returns a JSON object with purchase_id, token, status_url, read_with, paid, authorized, and more.
Inputs
requeststringrequired- The list you need, in plain words.
countinteger- How many matches to look for.
specstream_capture_capacity_referralRemember the first referral visit for sign-up within thirty days.WriteCapture Capacity Referral
Remember the first referral visit for sign-up within thirty days. Returns a JSON object with data.
Inputs
refstringrequired- Ref for capture capacity referral.
specstream_change_capacity_membershipChange, cancel, or resume the membership for its next renewal.WriteChange Capacity Membership
Change, cancel, or resume the membership for its next renewal. Returns a JSON object with data.
Inputs
actionstringrequired- Action for change capacity membership. One of: change, cancel, resume.one of
changecancelresume idempotency_keystringrequired- Idempotency Key for change capacity membership.
plan_idstring- Plan ID for change capacity membership.
specstream_claim_free_capacityClaim the one-time free balance for a verified eligible account.WriteClaim Free Capacity
Claim the one-time free balance for a verified eligible account. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_create_account_keyCreate ss_live_ or ss_test_ key.WriteCreate Account Key
Create ss_live_ or ss_test_ key. Returns a JSON object with data.
Inputs
engine_ruleobject- The engines a key's searches may ask (listed at /v1/search-engines): each item an engine's name or the two-letter ISO 3166-1 code of the country its operator runs it from. An engine is asked when ``allow`` is empty or names it or its country, and ``deny`` names neither.
eu_egress_onlyboolean- Eu Egress Only for create account key.default
false expires_in_daysinteger- Days until the key stops working. Without it, or with null, the key works until it is revoked.
namestring- Name for create account key.default
key project_idstring- Project ID for create account key.
scopesarray- Scopes for create account key.
spend_cap_centsinteger- The most the key spends in total, in cents, counted over every call since the key was made. The account's balance and limits apply as well.default
0 zero_retentionboolean- Zero Retention for create account key.default
false
specstream_create_browser_sessionOpen a browser: a real Chromium you drive over the Chrome DevTools Protocol with Playwright, Puppeteer, browser-use or Stagehand, or step by step through actions_url.WriteCreate Browser Session
Open a browser: a real Chromium you drive over the Chrome DevTools Protocol with Playwright, Puppeteer, browser-use or Stagehand, or step by step through actions_url. Charged per second it runs and per action. Returns a JSON object with data.
Inputs
allowed_domainsarray- Hosts the browser may open, such as example.com or *.example.com. Empty allows every public host. A page outside them is refused with blocked.
block_mediaboolean- true skips images, video, audio and fonts: pages load faster and the session reads fewer bytes.default
false headlessboolean- false runs the browser with a screen, for sites that act differently without one. It uses more memory.default
true idempotency_keystring- Your id for this call, at most 128 characters. The same id again answers with the same session and opens no second one.
idle_timeout_sinteger- The session ends after this many seconds with no client connected and no action. With keep_alive false, a disconnect ends it at once.default
60 keep_aliveboolean- true keeps the session when the client disconnects, so a new client can connect, until idle_timeout_s passes. false ends it at the disconnect.default
false metadataobject- Your own labels for the session, returned as sent.
timeout_sinteger- The most seconds the session runs. It ends then, connected or not.default
300 viewportobject- Viewport for create browser session.
specstream_create_capacity_fundingPrepare owner-authorized balance or membership checkout without starting work.WriteCreate Capacity Funding
Prepare owner-authorized balance or membership checkout without starting work. Returns a JSON object with data.
Inputs
idempotency_keystringrequired- Idempotency Key for create capacity funding.
kindstringrequired- Kind for create capacity funding. One of: topup, subscription, search_pack.one of
topupsubscriptionsearch_pack amount_centsinteger- Amount Cents for create capacity funding.
currencystring- Currency for create capacity funding. One of: usd, eur.one of
usdeur intended_quote_idstring- Intended Quote ID for create capacity funding.
plan_idstring- Plan ID for create capacity funding.
search_pack_idstring- Search Pack ID for create capacity funding.
specstream_create_capacity_refund_claimReport a wrong result for review against its sources.WriteCreate Capacity Refund Claim
Report a wrong result for review against its sources. Returns a JSON object with data.
Inputs
idempotency_keystringrequired- Idempotency Key for create capacity refund claim.
reasonstringrequired- Reason for create capacity refund claim.
reservation_idstringrequired- Reservation ID for create capacity refund claim.
unit_idsarrayrequired- Unit IDS for create capacity refund claim.
specstream_create_capacity_scheduleApprove future runs of an exact request within set spending limits.WriteCreate Capacity Schedule
Approve future runs of an exact request within set spending limits. Returns a JSON object with data.
Inputs
cadence_secondsintegerrequired- Cadence Seconds for create capacity schedule.
first_due_atstringrequired- First Due At for create capacity schedule.
idempotency_keystringrequired- Idempotency Key for create capacity schedule.
per_run_centsintegerrequired- Per Run Cents for create capacity schedule.
period_centsintegerrequired- Period Cents for create capacity schedule.
scopeobjectrequired- Scope for create capacity schedule.
valid_untilstringrequired- Valid Until for create capacity schedule.
calendar_scheduleobject- Calendar Schedule for create capacity schedule.
specstream_create_customer_webhookRegister find.completed webhook.WriteCreate Customer Webhook
Register find.completed webhook. Returns a JSON object with data.
Inputs
urlstringrequired- URL for create customer webhook.
event_namestring- Event Name for create customer webhook. One of: find.completed, monitor.found, collection.records_added, auto_topup.paid, auto_topup.failed, balance.low, research.completed, research.failed, research.cancelled.one of
find.completedmonitor.foundcollection.records_addedauto_topup.paidauto_topup.failedbalance.lowresearch.completedresearch.failedresearch.cancelleddefaultfind.completed eventsarray- Events for create customer webhook.
specstream_create_destination_syncKeep sending new and changed records to this destination.WriteCreate Destination Sync
Keep sending new and changed records to this destination. Returns a JSON object with data.
Inputs
collectionIdstringrequired- Collectionid for create destination sync.
connection_idstringrequired- Connection ID for create destination sync.
destination_sha256stringrequired- Destination Sha256 for create destination sync.
keepSendingboolean- Keepsending for create destination sync.default
true
specstream_create_investigation_functionMake a saved request run once per row by turning some of its values into typed inputs.WriteCreate Investigation Function
Make a saved request run once per row by turning some of its values into typed inputs. Nothing runs and nothing is charged. Returns a JSON object with data.
Inputs
namestringrequired- Name for create investigation function.
parametersarrayrequired- Parameters for create investigation function.
revision_idstringrequired- Revision ID for create investigation function.
spec_idstringrequired- Spec ID for create investigation function.
specstream_create_projectCreate a project with an explicit bounded authorization ceiling.WriteCreate Project
Create a project with an explicit bounded authorization ceiling. Returns a JSON object with data.
Inputs
namestringrequired- Name for create project.
monthly_spend_cap_centsinteger- Monthly Spend Cap Cents for create project.default
0
specstream_create_researchStart a research report: the run plans the question, searches the live web, reads pages and writes a report in which each cited sentence links to the page it was read from.WriteCreate Research
Start a research report: the run plans the question, searches the live web, reads pages and writes a report in which each cited sentence links to the page it was read from. Answers at once with the run's id; charged once, at delivery, at the depth's price. Returns a JSON object with data.
Inputs
inputstringrequired- Input for create research.
after_datestring- After Date for create research.
depthstring- Depth for create research. One of: quick, standard, deep.one of
quickstandarddeepdefaultstandard exclude_domainsarray- Exclude Domains for create research.
idempotency_keystring- Your id for this run, at most 128 characters. The same id with the same body answers with the same run; with another body it is refused with 409.
include_domainsarray- Include Domains for create research.
languagestring- Language for create research.
lengthstring- Length for create research. One of: short, standard, long.one of
shortstandardlongdefaultstandard metadataobject- Metadata for create research.
outputobject- Output for create research.
webhookobject- Webhook for create research.
specstream_create_specSave a request as its first revision.WriteCreate Spec
Save a request as its first revision. Returns a JSON object with data. Provide exactly one of: ast, source_find_id.
Inputs
namestringrequired- Name for create spec.
astobject- Ast for create spec.
contextstring- Context for create spec.default
project_idstring- Project ID for create spec.
qstring- The request in the person's own words. Lists run from this version are named from it. Without it, the lists are named from the reading.
source_find_idstring- Source Find ID for create spec.
specstream_create_spec_linkShare a saved request revision as a link, without its results or permission to spend.WriteCreate Spec Link
Share a saved request revision as a link, without its results or permission to spend. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
expected_ast_hashstringrequired- Expected Ast Hash for create spec link.
idstringrequired- ID for create spec link.
revision_idstringrequired- Revision ID for create spec link.
expires_secondsinteger- Expires Seconds for create spec link.default
2592000 include_contextboolean- Include Context for create spec link.default
false
specstream_export_findOne-use signed download.WriteExport Find
One-use signed download. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
formatstringrequired- Owned Delivery export formats, including maps from supplied coordinates. One of: xlsx, csv, json, html, kml, geojson.one of
xlsxcsvjsonhtmlkmlgeojson idstringrequired- ID for export find.
specstream_import_cloud_listImport supplied records from a connected table or workbook.WriteImport Cloud List
Import supplied records from a connected table or workbook. Returns a JSON object with data.
Inputs
connection_idstringrequired- Connection ID for import cloud list.
import_idstringrequired- Import ID for import cloud list.
linkstringrequired- Link for import cloud list.
namestringrequired- Name for import cloud list.
identity_columnstring- Identity Column for import cloud list.
keepUpdatedboolean- Keepupdated for import cloud list.default
true mappingobject- Mapping for import cloud list.
project_idstring- Project ID for import cloud list.
sheet_idstring- Sheet ID for import cloud list.
source_sha256string- Source Sha256 for import cloud list.
specstream_import_file_commandImport supplied CSV or XLSX values without starting research.WriteImport File Command
Import supplied CSV or XLSX values without starting research. Returns a JSON object with data.
Inputs
formatstringrequired- Format for import file command.
import_idstringrequired- Import ID for import file command.
namestringrequired- Name for import file command.
contentstring- Content for import file command.
content_base64string- Content Base64 for import file command.
mappingobject- Mapping for import file command.
project_idstring- Project ID for import file command.
sheetstring- Sheet for import file command.
specstream_open_support_ticketCorrection or report ticket.WriteOpen Support Ticket
Correction or report ticket. Returns a JSON object with data.
Inputs
kindstringrequired- Kind for open support ticket. One of: correction, report, opt_out, export, delete.one of
correctionreportopt_outexportdelete bodystring- Body for open support ticket.default
entity_idstring- Entity ID for open support ticket.
find_idstring- Find ID for open support ticket.
reasonstring- Reason for open support ticket.
specstream_opt_outPublic suppression opt-out.WriteOpt Out
Public suppression opt-out. Returns a JSON object with data.
Inputs
emailstring- Email for opt out.
employerstring- Employer for opt out.
namestring- Name for opt out.
phonestring- Phone for opt out.
profile_urlstring- Profile URL for opt out.
websitestring- Website for opt out.
specstream_prepare_investigation_batchBind the selected rows to the inputs and return one quote: the distinct searches, rows with missing inputs, searches reused from earlier work, and one maximum.WritePrepare Investigation Batch
Bind the selected rows to the inputs and return one quote: the distinct searches, rows with missing inputs, searches reused from earlier work, and one maximum. Nothing runs yet. Returns a JSON object with data.
Inputs
bindingsobjectrequired- Bindings for prepare investigation batch.
collection_idstringrequired- Collection ID for prepare investigation batch.
function_idstringrequired- Function ID for prepare investigation batch.
record_idsarrayrequired- Record IDS for prepare investigation batch.
request_idstringrequired- Request ID for prepare investigation batch.
reuse_completedboolean- Reuse Completed for prepare investigation batch.default
true
specstream_prepare_reconciliationCompare two of your lists with exact or close-spelling rules and conflict checks, and propose which rows correspond.WritePrepare Reconciliation
Compare two of your lists with exact or close-spelling rules and conflict checks, and propose which rows correspond. Returns a JSON object with data.
Inputs
fillarrayrequired- Fill for prepare reconciliation.
groupsarrayrequired- Groups for prepare reconciliation.
leftobjectrequired- Left for prepare reconciliation.
namestringrequired- Name for prepare reconciliation.
request_idstringrequired- Request ID for prepare reconciliation.
rightobjectrequired- Right for prepare reconciliation.
assignmentstring- Assignment for prepare reconciliation. One of: one_to_one, many_to_one.one of
one_to_onemany_to_onedefaultone_to_one include_private_fieldsboolean- Include Private Fields for prepare reconciliation.default
false project_idstring- Project ID for prepare reconciliation.
vetoesarray- Vetoes for prepare reconciliation.
specstream_prepare_research_rulePrepare a rule that researches rows when they first become ready or when their inputs change, with a per-run and a total spending limit.WritePrepare Research Rule
Prepare a rule that researches rows when they first become ready or when their inputs change, with a per-run and a total spending limit. Nothing runs until it's approved. Returns a JSON object with data.
Inputs
bindingsobjectrequired- Bindings for prepare research rule.
collection_idstringrequired- Collection ID for prepare research rule.
function_idstringrequired- Function ID for prepare research rule.
namestringrequired- Name for prepare research rule.
per_batch_centsintegerrequired- Per Batch Cents for prepare research rule.
request_idstringrequired- Request ID for prepare research rule.
total_centsintegerrequired- Total Cents for prepare research rule.
valid_untilstringrequired- Valid Until for prepare research rule.
batch_sizeinteger- Batch Size for prepare research rule.default
20 conditionsarray- Conditions for prepare research rule.
include_existingboolean- Include Existing for prepare research rule.default
false reuse_completedboolean- Reuse Completed for prepare research rule.default
true triggerstring- Trigger for prepare research rule. One of: first_ready, input_changed.one of
first_readyinput_changeddefaultfirst_ready
specstream_put_project_memberSet a current project member role and bounded spending ceiling.WritePut Project Member
Set a current project member role and bounded spending ceiling. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
account_idstringrequired- Account ID for put project member.
idstringrequired- ID for put project member.
rolestringrequired- Role for put project member. One of: editor, viewer.one of
editorviewer monthly_spend_cap_centsinteger- Monthly Spend Cap Cents for put project member.default
0
specstream_reconcile_destination_exportCheck an uncertain delivery without sending it again.WriteReconcile Destination Export
Check an uncertain delivery without sending it again. Returns a JSON object with data. Needs identity, export_id (identifiers returned by earlier SpecStream calls).
Inputs
export_idstringrequired- Export ID for reconcile destination export.
identitystringrequired- Identity for reconcile destination export.
specstream_reconcile_find_commerceRecover the existing purchase without rerunning work.WriteReconcile Find Commerce
Recover the existing purchase without rerunning work. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for reconcile find commerce.
specstream_release_browser_sessionClose a browser session and settle its charge.WriteRelease Browser Session
Close a browser session and settle its charge. A repeat call answers the same. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for release browser session.
specstream_request_capacity_custom_planRequest an Enterprise conversation without granting an entitlement.WriteRequest Capacity Custom Plan
Request an Enterprise conversation without granting an entitlement. Returns a JSON object with data.
Inputs
briefstringrequired- Brief for request capacity custom plan.
specstream_restore_capacity_store_purchasesRecover verified purchases without duplicate balance grants.WriteRestore Capacity Store Purchases
Recover verified purchases without duplicate balance grants. Returns a JSON object with data.
Inputs
purchasesarrayrequired- Purchases for restore capacity store purchases.
specstream_revise_specCreate an immutable revision only if the expected head still matches.WriteRevise Spec
Create an immutable revision only if the expected head still matches. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
astobjectrequired- Ast for revise spec.
expected_revision_idstringrequired- Expected Revision ID for revise spec.
idstringrequired- ID for revise spec.
contextstring- Context for revise spec.
namestring- Name for revise spec.
parent_revision_idstring- The revision of the same request that the new version branches from. Without it, the new version branches from the current head. expected_revision_id still protects the current head against concurrent edits.
qstring- The revised request in the person's own words. Lists run from this version are named from it. Without it, the lists are named from the reading.
specstream_run_capacity_schedule_nowRun active recurring work once now, inside its own limits, without moving its schedule.WriteRun Capacity Schedule Now
Run active recurring work once now, inside its own limits, without moving its schedule. Returns a JSON object with data. Needs schedule_id (identifiers returned by earlier SpecStream calls).
Inputs
schedule_idstringrequired- Schedule ID for run capacity schedule now.
specstream_save_connection_destinationSave a provider-verified destination and field mapping.WriteSave Connection Destination
Save a provider-verified destination and field mapping. Returns a JSON object with data. Needs identity (identifiers returned by earlier SpecStream calls).
Inputs
identitystringrequired- Identity for save connection destination.
selectionobjectrequired- Selection for save connection destination.
specstream_save_web_source_listSave a reviewed preview as an imported list, using its preview hash.WriteSave Web Source List
Save a reviewed preview as an imported list, using its preview hash. Saving does not research or spend; quote and approve research on the list afterward. Returns a JSON object with data.
Inputs
import_idstringrequired- Import ID for save web source list.
namestringrequired- Name for save web source list.
preview_hashstringrequired- Preview Hash for save web source list.
preview_idstringrequired- Preview ID for save web source list.
mappingobject- Mapping for save web source list.
specstream_send_to_destinationSend selected owned results with durable delivery identities.WriteSend To Destination
Send selected owned results with durable delivery identities. Returns a JSON object with data. Needs identity (identifiers returned by earlier SpecStream calls).
Inputs
destination_sha256stringrequired- Destination Sha256 for send to destination.
entity_idsarrayrequired- Entity IDS for send to destination.
find_idstringrequired- Find ID for send to destination.
identitystringrequired- Identity for send to destination.
specstream_set_account_spendSet an explicit owner authorization ceiling without funding or spending.WriteSet Account Spend
Set an explicit owner authorization ceiling without funding or spending. Returns a JSON object with data.
Inputs
spend_ceiling_centsintegerrequired- Spend Ceiling Cents for set account spend.
specstream_set_capacity_auto_topupTurn automatic top-up on or off and set its level, amount or search pack, and monthly limits (owner only).WriteSet Capacity Auto Topup
Turn automatic top-up on or off and set its level, amount or search pack, and monthly limits (owner only). Returns a JSON object with data.
- Idempotent
Inputs
This tool takes no inputs.
specstream_set_capacity_budgetSet an owner-approved monthly account spending maximum.WriteSet Capacity Budget
Set an owner-approved monthly account spending maximum. Returns a JSON object with data.
Inputs
monthly_centsintegerrequired- Monthly Cents for set capacity budget.
specstream_start_capacity_auto_topup_cardOpen a Stripe page to save or change the card for automatic top-up, with no payment (owner only).WriteStart Capacity Auto Topup Card
Open a Stripe page to save or change the card for automatic top-up, with no payment (owner only). Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_start_capacity_requestAsk for a list in plain words and run it within a maximum price, answering at once.WriteStart Capacity Request
Ask for a list in plain words and run it within a maximum price, answering at once. Returns a JSON object with data.
Inputs
confirm_max_centsintegerrequired- Confirm Max Cents for start capacity request.
idempotency_keystringrequired- Idempotency Key for start capacity request.
callback_onstring- "start" tells the callback when the run starts. "done" posts the finished rows to it when the run ends, as GET /v1/capacity/requests/{key}/rows answers them, in parts of at most 90 KB. Both tell it when nothing runs. One of: start, done.one of
startdonedefaultstart callback_urlstring- Callback URL for start capacity request.
fieldsarray- What to bring back for each row, in plain words, such as "headcount" or "Is it hiring for a finance role?". q can ask the same in one sentence.
localestring- Locale for start capacity request.default
en-US maximum_price_usdnumber- Maximum Price Usd for start capacity request.
one_row_perstring- For the rows posted when done: one flat row per item of this list field, such as "people" for one person per row.
qstring- What to find, in plain words. With rows, what to bring back for each row.
requested_unitsinteger- Requested Units for start capacity request.default
25 rowsarray- Companies to enrich, one object per row: the company name, website or domain, and any other columns that identify it. Each row is one result.
specstream_start_crawlStart a crawl: read a site page by page, breadth first, as a job to poll.WriteStart Crawl
Start a crawl: read a site page by page, breadth first, as a job to poll. Each page that gives text is one page read. Returns a JSON object with data.
Inputs
urlstringrequired- URL for start crawl.
entire_domainboolean- Entire Domain for start crawl.default
false exclude_pathsarray- Exclude Paths for start crawl.
formatstring- Format for start crawl. One of: markdown, text, html.one of
markdowntexthtmldefaultmarkdown idempotency_keystring- Your id for this call, at most 128 characters. The same id again answers with the same map charge or the same crawl job.
includearray- Include for start crawl.
include_pathsarray- Include Paths for start crawl.
include_subdomainsboolean- Include Subdomains for start crawl.default
false limitinteger- Limit for start crawl.default
100 max_depthinteger- Max Depth for start crawl.
sitemapstring- Sitemap for start crawl. One of: include, skip.one of
includeskipdefaultinclude
specstream_transfer_capacity_store_to_cardAuthorize a recoverable Google Play to card billing transfer.WriteTransfer Capacity Store To Card
Authorize a recoverable Google Play to card billing transfer. Returns a JSON object with data.
Inputs
idempotency_keystringrequired- Idempotency Key for transfer capacity store to card.
plan_idstringrequired- Plan ID for transfer capacity store to card.
specstream_update_account_keyTurn zero retention on or off for an API key.WriteUpdate Account Key
Turn zero retention on or off for an API key. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for update account key.
engine_ruleobject- The engines a key's searches may ask (listed at /v1/search-engines): each item an engine's name or the two-letter ISO 3166-1 code of the country its operator runs it from. An engine is asked when ``allow`` is empty or names it or its country, and ``deny`` names neither.
eu_egress_onlyboolean- Eu Egress Only for update account key.
expires_atstring- When the key stops working, a future time; null removes the end.
namestring- Name for update account key.
spend_cap_centsinteger- The most the key spends in total, in cents, counted over every call since the key was made. The account's balance and limits apply as well.
zero_retentionboolean- Zero Retention for update account key.
specstream_update_cloud_importStart or stop daily source checks.WriteUpdate Cloud Import
Start or stop daily source checks. Returns a JSON object with data. Needs import_id (identifiers returned by earlier SpecStream calls).
Inputs
import_idstringrequired- Import ID for update cloud import.
keepUpdatedbooleanrequired- Keepupdated for update cloud import.
specstream_update_destination_syncStart or stop continuous destination delivery.WriteUpdate Destination Sync
Start or stop continuous destination delivery. Returns a JSON object with data. Needs sync_id (identifiers returned by earlier SpecStream calls).
Inputs
keepSendingbooleanrequired- Keepsending for update destination sync.
sync_idstringrequired- Sync ID for update destination sync.
specstream_update_projectUpdate a project only if the expected version matches.WriteUpdate Project
Update a project only if the expected version matches. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
expected_versionintegerrequired- Expected Version for update project.
idstringrequired- ID for update project.
monthly_spend_cap_centsinteger- Monthly Spend Cap Cents for update project.
namestring- Name for update project.
specstream_verify_capacity_store_purchaseConfirm an app store purchase before adding its balance.WriteVerify Capacity Store Purchase
Confirm an app store purchase before adding its balance. Returns a JSON object with data.
Inputs
product_idstringrequired- Product ID for verify capacity store purchase.
providerstringrequired- Provider for verify capacity store purchase. One of: app_store, google_play.one of
app_storegoogle_play purchase_tokenstringrequired- Purchase Token for verify capacity store purchase.
specstream_workspace_add_noteAdd a versioned note to an authorized project or collection record.WriteWorkspace Add Note
Add a versioned note to an authorized project or collection record. Returns a JSON object with data.
Inputs
expected_versionintegerrequired- Expected Version for workspace add note.
idstringrequired- ID for workspace add note.
textstringrequired- Text for workspace add note.
collection_idstring- Collection ID for workspace add note.
project_idstring- Project ID for workspace add note.
record_idstring- Record ID for workspace add note.
specstream_workspace_add_sso_domainCreate an account-owned domain verification challenge.WriteWorkspace Add SSO Domain
Create an account-owned domain verification challenge. Returns a JSON object with data.
Inputs
domainstringrequired- Domain for workspace add sso domain.
specstream_workspace_combine_collectionsCombine your lists into one and keep each row's sources.WriteWorkspace Combine Collections
Combine your lists into one and keep each row's sources. Returns a JSON object with data.
Inputs
collection_idsarrayrequired- Collection IDS for workspace combine collections.
namestringrequired- Name for workspace combine collections.
request_idstringrequired- Request ID for workspace combine collections.
project_idstring- Project ID for workspace combine collections.
specstream_workspace_copy_collectionCopy rows from a list you can open into a separate list you own.WriteWorkspace Copy Collection
Copy rows from a list you can open into a separate list you own. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
collection_idstringrequired- Collection ID for workspace copy collection.
namestringrequired- Name for workspace copy collection.
request_idstringrequired- Request ID for workspace copy collection.
project_idstring- Project ID for workspace copy collection.
specstream_workspace_edit_noteEdit a note you wrote with an expected version.WriteWorkspace Edit Note
Edit a note you wrote with an expected version. Returns a JSON object with data. Needs note_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
expected_versionintegerrequired- Expected Version for workspace edit note.
note_idstringrequired- Note ID for workspace edit note.
textstringrequired- Text for workspace edit note.
collection_idstring- Collection ID for workspace edit note.
project_idstring- Project ID for workspace edit note.
record_idstring- Record ID for workspace edit note.
specstream_workspace_invite_memberInvite a project member under current project management authority.WriteWorkspace Invite Member
Invite a project member under current project management authority. Returns a JSON object with data.
Inputs
emailstringrequired- Email for workspace invite member.
project_idstringrequired- Project ID for workspace invite member.
request_idstringrequired- Request ID for workspace invite member.
expires_in_daysinteger- Expires In Days for workspace invite member. One of: 1, 7, 30.one of
1730default7 monthly_spend_cap_centsinteger- Monthly Spend Cap Cents for workspace invite member.default
0 rolestring- Role for workspace invite member. One of: editor, viewer.one of
editorviewerdefaulteditor
specstream_workspace_name_passkeyName an account-owned passkey.WriteWorkspace Name Passkey
Name an account-owned passkey. Returns a JSON object with data. Needs credential_id (identifiers returned by earlier SpecStream calls).
Inputs
credential_idstringrequired- Credential ID for workspace name passkey.
labelstringrequired- Label for workspace name passkey.
specstream_workspace_passkey_sign_inVerify a passkey assertion and establish a session.WriteWorkspace Passkey Sign In
Verify a passkey assertion and establish a session. Returns a JSON object with data.
Inputs
challenge_idstringrequired- Challenge ID for workspace passkey sign in.
credentialobjectrequired- Credential for workspace passkey sign in.
specstream_workspace_passkey_sign_in_optionsStart a browser-bound passkey sign-in ceremony.WriteWorkspace Passkey Sign In Options
Start a browser-bound passkey sign-in ceremony. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_workspace_read_notificationsMark the supplied authorized notifications read atomically.WriteWorkspace Read Notifications
Mark the supplied authorized notifications read atomically. Returns a JSON object with data.
Inputs
idsarrayrequired- IDS for workspace read notifications.
specstream_workspace_redeem_native_providerRedeem verified provider proof for an app session or connection.WriteWorkspace Redeem Native Provider
Redeem verified provider proof for an app session or connection. Returns a JSON object with data.
Inputs
code_verifierstringrequired- Code Verifier for workspace redeem native provider.
handoff_idstringrequired- Handoff ID for workspace redeem native provider.
specstream_workspace_register_passkeyVerify and register a passkey for the current account.WriteWorkspace Register Passkey
Verify and register a passkey for the current account. Returns a JSON object with data.
Inputs
challenge_idstringrequired- Challenge ID for workspace register passkey.
credentialobjectrequired- Credential for workspace register passkey.
labelstringrequired- Label for workspace register passkey.
specstream_workspace_register_passkey_optionsStart a browser-bound passkey registration ceremony.WriteWorkspace Register Passkey Options
Start a browser-bound passkey registration ceremony. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_workspace_register_push_deviceRegister the current signed-in device for native notifications.WriteWorkspace Register Push Device
Register the current signed-in device for native notifications. Returns a JSON object with data.
Inputs
namestringrequired- Name for workspace register push device.
platformstringrequired- Platform for workspace register push device. One of: apns, fcm.one of
apnsfcm tokenstringrequired- Token for workspace register push device.
specstream_workspace_register_web_push_subscriptionRegister an encrypted browser push subscription for this signed-in account.WriteWorkspace Register Web Push Subscription
Register an encrypted browser push subscription for this signed-in account. Returns a JSON object with data.
Inputs
endpointstringrequired- Endpoint for workspace register web push subscription.
keysobjectrequired- Keys for workspace register web push subscription.
namestringrequired- Name for workspace register web push subscription.
expirationTimeinteger- Expirationtime for workspace register web push subscription.
specstream_workspace_report_resultReport a billed result for review within its guarantee period.WriteWorkspace Report Result
Report a billed result for review within its guarantee period. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
Inputs
checkstringrequired- Check for workspace report result.
collection_idstringrequired- Collection ID for workspace report result.
record_idstringrequired- Record ID for workspace report result.
request_idstringrequired- Request ID for workspace report result.
truthstringrequired- Truth for workspace report result.
linkstring- Link for workspace report result.
specstream_workspace_resolve_noteResolve or reopen an authorized note with an expected version.WriteWorkspace Resolve Note
Resolve or reopen an authorized note with an expected version. Returns a JSON object with data. Needs note_id (identifiers returned by earlier SpecStream calls).
Inputs
expected_versionintegerrequired- Expected Version for workspace resolve note.
note_idstringrequired- Note ID for workspace resolve note.
resolvedbooleanrequired- Resolved for workspace resolve note.
collection_idstring- Collection ID for workspace resolve note.
project_idstring- Project ID for workspace resolve note.
record_idstring- Record ID for workspace resolve note.
specstream_workspace_save_relationshipsSave a personal relationship column with an expected version.WriteWorkspace Save Relationships
Save a personal relationship column with an expected version. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
collection_idstringrequired- Collection ID for workspace save relationships.
expected_versionintegerrequired- Expected Version for workspace save relationships.
field_idstringrequired- Field ID for workspace save relationships.
labelstringrequired- Label for workspace save relationships.
specstream_workspace_save_viewSave a versioned personal view without changing source records.WriteWorkspace Save View
Save a versioned personal view without changing source records. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
collection_idstringrequired- Collection ID for workspace save view.
expected_versionintegerrequired- Expected Version for workspace save view.
viewobjectrequired- View for workspace save view.
specstream_workspace_set_schedule_deliverySet versioned monitor delivery settings without starting work.WriteWorkspace Set Schedule Delivery
Set versioned monitor delivery settings without starting work. Returns a JSON object with data. Needs schedule_id (identifiers returned by earlier SpecStream calls).
Inputs
expected_versionintegerrequired- Expected Version for workspace set schedule delivery.
schedule_idstringrequired- Schedule ID for workspace set schedule delivery.
notifyboolean- Notify for workspace set schedule delivery.default
true sendTostring- Sendto for workspace set schedule delivery.
slackstring- Slack for workspace set schedule delivery.
webhookstring- Webhook for workspace set schedule delivery.
specstream_workspace_set_sso_policySet SSO enforcement after a successful provider test.WriteWorkspace Set SSO Policy
Set SSO enforcement after a successful provider test. Returns a JSON object with data. Needs domain_id (identifiers returned by earlier SpecStream calls).
Inputs
domain_idstringrequired- Domain ID for workspace set sso policy.
require_ssobooleanrequired- Require SSO for workspace set sso policy.
scim_enabledbooleanrequired- SCIM Enabled for workspace set sso policy.
specstream_workspace_set_your_field_valueSet or clear one of your fields on selected records.WriteWorkspace Set Your Field Value
Set or clear one of your fields on selected records. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
collection_idstringrequired- Collection ID for workspace set your field value.
expected_versionintegerrequired- Expected Version for workspace set your field value.
keystringrequired- Key for workspace set your field value.
record_idsarrayrequired- Record IDS for workspace set your field value.
valuestring- Value for workspace set your field value.
specstream_workspace_star_itemStar or unstar currently authorized work with an expected version.WriteWorkspace Star Item
Star or unstar currently authorized work with an expected version. Returns a JSON object with data.
- Idempotent
Inputs
expected_versionintegerrequired- Expected Version for workspace star item.
itemobjectrequired- Item for workspace star item.
starredbooleanrequired- Starred for workspace star item.
specstream_workspace_start_native_providerBegin native provider authorization bound to an app-held PKCE secret.WriteWorkspace Start Native Provider
Begin native provider authorization bound to an app-held PKCE secret. Returns a JSON object with data.
Inputs
code_challengestringrequired- Code Challenge for workspace start native provider.
providerstringrequired- Provider for workspace start native provider.
emailstring- Email for workspace start native provider.
enrollboolean- Enroll for workspace start native provider.default
false purposestring- Purpose for workspace start native provider. One of: signin, connection.one of
signinconnectiondefaultsignin refstring- Ref for workspace start native provider.
specstream_workspace_start_placementApprove the placement quote and enqueue durable background placement.WriteWorkspace Start Placement
Approve the placement quote and enqueue durable background placement. Returns a JSON object with data. Needs import_id (identifiers returned by earlier SpecStream calls).
Inputs
confirm_max_centsintegerrequired- Confirm Max Cents for workspace start placement.
import_idstringrequired- Import ID for workspace start placement.
quote_hashstringrequired- Quote Hash for workspace start placement.
quote_idstringrequired- Quote ID for workspace start placement.
request_idstringrequired- Request ID for workspace start placement.
specstream_workspace_start_ssoStart a single-use browser-bound SAML sign-in.WriteWorkspace Start SSO
Start a single-use browser-bound SAML sign-in. Returns a JSON object with data.
Inputs
domainstringrequired- Domain for workspace start sso.
enrollboolean- Enroll for workspace start sso.default
false
specstream_workspace_update_notificationPersist read or archive state from your signed-in browser.WriteWorkspace Update Notification
Persist read or archive state from your signed-in browser. Returns a JSON object with data.
Inputs
identifierstringrequired- Identifier for workspace update notification.
archivedboolean- Archived for workspace update notification.
readboolean- Read for workspace update notification.
specstream_workspace_verify_sso_domainVerify the account's domain through its DNS TXT record.WriteWorkspace Verify SSO Domain
Verify the account's domain through its DNS TXT record. Returns a JSON object with data. Needs domain_id (identifiers returned by earlier SpecStream calls).
Inputs
domain_idstringrequired- Domain ID for workspace verify sso domain.
specstream_cancel_capacity_fundingClose an unpaid funding request without duplicating payment.DestructiveCancel Capacity Funding
Close an unpaid funding request without duplicating payment. Returns a JSON object with data. Needs funding_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
funding_idstringrequired- Funding ID for cancel capacity funding.
specstream_cancel_crawlStop a crawl job; the pages it read stay.DestructiveCancel Crawl
Stop a crawl job; the pages it read stay. Returns a JSON object with data. Needs crawl_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
crawl_idstringrequired- Crawl ID for cancel crawl.
specstream_cancel_findRequest cancel.DestructiveCancel Find
Request cancel. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for cancel find.
specstream_cancel_investigation_batchStop searches that haven't started and cancel running ones where possible.DestructiveCancel Investigation Batch
Stop searches that haven't started and cancel running ones where possible. Finished results stay yours. Returns a JSON object with data. Needs batch_id (identifiers returned by earlier SpecStream calls).
Inputs
batch_idstringrequired- Batch ID for cancel investigation batch.
specstream_cancel_researchStop a research run at its next step; a cancelled run is not charged.DestructiveCancel Research
Stop a research run at its next step; a cancelled run is not charged. Returns a JSON object with data. Needs run_id (identifiers returned by earlier SpecStream calls).
Inputs
run_idstringrequired- Run ID for cancel research.
specstream_delete_accountRevoke and grace purge.DestructiveDelete Account
Revoke and grace purge. Returns a JSON object with data.
Inputs
This tool takes no inputs.
specstream_disconnect_connectionRevoke a connected provider.DestructiveDisconnect Connection
Revoke a connected provider. Returns a JSON object with data. Needs identity (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
identitystringrequired- Identity for disconnect connection.
specstream_patch_research_rulePause, resume or delete a rule.DestructivePatch Research Rule
Pause, resume or delete a rule. Pausing holds queued searches; running ones finish. Resuming never raises the limits. Returns a JSON object with data. Needs rule_id (identifiers returned by earlier SpecStream calls).
Inputs
expected_versionintegerrequired- Expected Version for patch research rule.
rule_idstringrequired- Rule ID for patch research rule.
statestringrequired- State for patch research rule. One of: active, paused, deleted.one of
activepauseddeleted
specstream_remove_capacity_auto_topup_cardRemove the saved card; automatic top-up turns off (owner only).DestructiveRemove Capacity Auto Topup Card
Remove the saved card; automatic top-up turns off (owner only). Returns a JSON object with data.
- Idempotent
Inputs
This tool takes no inputs.
specstream_revoke_account_keyRevoke an API key.DestructiveRevoke Account Key
Revoke an API key. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
idstringrequired- ID for revoke account key.
specstream_revoke_customer_webhookRevoke an owned callback and cancel queued deliveries.DestructiveRevoke Customer Webhook
Revoke an owned callback and cancel queued deliveries. Returns a JSON object with data. Needs id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
idstringrequired- ID for revoke customer webhook.
specstream_revoke_project_memberRevoke project membership without deleting owned work.DestructiveRevoke Project Member
Revoke project membership without deleting owned work. Returns a JSON object with data. Needs id, account_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
account_idstringrequired- Account ID for revoke project member.
idstringrequired- ID for revoke project member.
specstream_revoke_spec_linkTurn off a saved-request link without changing the request or its results.DestructiveRevoke Spec Link
Turn off a saved-request link without changing the request or its results. Returns a JSON object with data. Needs id, link_id (identifiers returned by earlier SpecStream calls).
Inputs
idstringrequired- ID for revoke spec link.
link_idstringrequired- Link ID for revoke spec link.
specstream_update_capacity_schedulePause, resume, or delete recurring work without buying missed occurrences.DestructiveUpdate Capacity Schedule
Pause, resume, or delete recurring work without buying missed occurrences. Returns a JSON object with data. Needs schedule_id (identifiers returned by earlier SpecStream calls).
Inputs
expected_versionintegerrequired- Expected Version for update capacity schedule.
schedule_idstringrequired- Schedule ID for update capacity schedule.
statestringrequired- State for update capacity schedule. One of: active, paused, deleted.one of
activepauseddeleted
specstream_workspace_configure_ssoConfigure verified SAML metadata for an owned domain.DestructiveWorkspace Configure SSO
Configure verified SAML metadata for an owned domain. Returns a JSON object with data. Needs domain_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
domain_idstringrequired- Domain ID for workspace configure sso.
metadata_urlstringrequired- Metadata URL for workspace configure sso.
providerstringrequired- Provider for workspace configure sso. One of: Okta, Microsoft Entra ID, Google Workspace, OneLogin, JumpCloud, Another SAML 2.0 provider.one of
OktaMicrosoft Entra IDGoogle WorkspaceOneLoginJumpCloudAnother SAML 2.0 provider
specstream_workspace_delete_noteRemove an authorized note with an expected version.DestructiveWorkspace Delete Note
Remove an authorized note with an expected version. Returns a JSON object with data. Needs note_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
expected_versionintegerrequired- Expected Version for workspace delete note.
note_idstringrequired- Note ID for workspace delete note.
collection_idstring- Collection ID for workspace delete note.
project_idstring- Project ID for workspace delete note.
record_idstring- Record ID for workspace delete note.
specstream_workspace_delete_passkeyRevoke an account-owned passkey.DestructiveWorkspace Delete Passkey
Revoke an account-owned passkey. Returns a JSON object with data. Needs credential_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
credential_idstringrequired- Credential ID for workspace delete passkey.
specstream_workspace_delete_photoRemove the current account's private profile photo.DestructiveWorkspace Delete Photo
Remove the current account's private profile photo. Returns a JSON object with data.
- Idempotent
Inputs
This tool takes no inputs.
specstream_workspace_revoke_push_deviceStop notifications to a registered device.DestructiveWorkspace Revoke Push Device
Stop notifications to a registered device. Returns a JSON object with data. Needs device_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
device_idstringrequired- Device ID for workspace revoke push device.
specstream_workspace_revoke_scim_tokenRevoke a domain's provisioning credential.DestructiveWorkspace Revoke SCIM Token
Revoke a domain's provisioning credential. Returns a JSON object with data. Needs domain_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
domain_idstringrequired- Domain ID for workspace revoke scim token.
specstream_workspace_rotate_scim_tokenRotate a verified domain's provisioning credential.DestructiveWorkspace Rotate SCIM Token
Rotate a verified domain's provisioning credential. Returns a JSON object with data. Needs domain_id (identifiers returned by earlier SpecStream calls).
Inputs
domain_idstringrequired- Domain ID for workspace rotate scim token.
specstream_workspace_save_your_fieldsAdd, rename or remove your own fields on a collection.DestructiveWorkspace Save Your Fields
Add, rename or remove your own fields on a collection. Returns a JSON object with data. Needs collection_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
collection_idstringrequired- Collection ID for workspace save your fields.
expected_versionintegerrequired- Expected Version for workspace save your fields.
fieldsarrayrequired- Fields for workspace save your fields.
specstream_workspace_set_scim_mappingsSet domain-to-project mappings under current owner authority.DestructiveWorkspace Set SCIM Mappings
Set domain-to-project mappings under current owner authority. Returns a JSON object with data. Needs domain_id (identifiers returned by earlier SpecStream calls).
- Idempotent
Inputs
domain_idstringrequired- Domain ID for workspace set scim mappings.
mappingsarrayrequired- Mappings for workspace set scim mappings.
No tools match.