Skip to the page
Get started free

Factory Droid

Ask Droid for records from the live web in plain words, see the price first, and get structured rows back in the terminal with a source on every value.

SpecStream for Factory DroidCoding agents

What you need

  • Factory's Droid CLI, signed in.
  • A SpecStream account. New accounts get $10 of work on sign-up, no card. Create one.

  1. 1. Add SpecStream

    Run this in a terminal. SpecStream is a remote server, so the type is http:

    Terminal
    droid mcp add specstream https://api.specstream.ai/mcp --type http

  2. 2. Sign in to SpecStream

    Start Droid and type /mcp. Select specstream and finish the sign-in in your browser: sign in or create an account, and approve the access Droid asks for. Until then droid mcp list shows the server as needing authentication. Requests run on the account that signed in, with its balance and spending limits.

  3. 3. Ask for data

    Describe the records you want and the details to bring back on each one:

    In Droid
    Find ten open-source libraries for parsing PDF files in Rust, with each one's license, latest release date, and repository. Use SpecStream.

  4. 4. Or connect with an API key

    Use a key on a machine with no browser. In SpecStream, open Agents & API, choose API keys, then Create API key, and set a total spending limit. Then add the server with the key as a header in place of the first step. --no-oauth stops Droid from starting a sign-in:

    Terminal with a key
    droid mcp add specstream https://api.specstream.ai/mcp --type http \
      --header "Authorization: Bearer <your SpecStream API key>" --no-oauth

What happens when you ask

SpecStream reads the request back, then quotes the most it can cost. Nothing runs until you approve that price. Rows arrive with the source URL and read time on every value.

Install the plugin instead

SpecStream also publishes its Claude Code plugin, which adds the server and four skills. Droid reads that layout. Run droid plugin marketplace add specstream/specstream-tools, then droid plugin marketplace list to see the marketplace name, and install with droid plugin install specstream@<marketplace name> --scope user. Use the plugin or the server steps above, not both.

Keep it in a file

droid mcp add saves the server to ~/.factory/mcp.json. A project can carry its own .factory/mcp.json in the project root, and Droid reloads when the file changes. The entry is named specstream, with type set to http and url set to https://api.specstream.ai/mcp. Keep API keys out of the project file. Without a key in the entry, each teammate signs in with their own SpecStream account.

If your organization limits MCP servers

When an MCP policy is on in your Factory organization, the server's hostname must be on its allowlist. Ask an admin to add api.specstream.ai.

Cost

Connecting SpecStream to Droid is free. Reading a request and pricing it cost nothing. Each matching row costs 5¢, 15¢ or $1, depending on how much the row needs, plus 5¢ for a person's email and 15¢ for a phone. A quote lasts 30 minutes, a run can't cost more than the maximum you approved, and a run that finds nothing costs nothing. Balance, quotes, and billing has the details.

Disconnect

Remove the specstream entry from mcp.json. To end Droid's access on the SpecStream side, open Agents & API in your workspace, choose OAuth applications, and revoke Droid, or revoke the key under API keys. Your saved results stay in your workspace. Questions go to [email protected].

More

SpecStream for Factory Droid covers what it does in Factory Droid on one page. Every other tool has its guide in Connect your tools. You see the most a request can cost before it starts, and the matches are paid from your balance. Billing has the details. For help, email [email protected].