Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to SpecStream

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the SpecStream connection

    In AgentKit > Connections, create a SpecStream connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. 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.actions
    const connector = 'specstream'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'specstream_get_account',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • specstream_agent_list_stepsRead the buying steps and the ways to pay.Read-only

    Agent 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-only

    Browser 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-only

    Dictation Capabilities

    Read configured hosted dictation support. Returns a JSON object with data.

    Inputs

    This tool takes no inputs.

  • specstream_export_accountAccount export.Read-only

    Export 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-only

    Extract 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 markdowntexthtmldefault markdown
    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-only

    Find 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-only

    Get 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-only

    Get 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.