Skip to the page
Get started free

Morphic

Point Morphic's SearXNG search at SpecStream with two settings: SEARCH_API=searxng, and SEARXNG_API_URL with your key in the address. Morphic then searches the live web through SpecStream's Search API at $1 per 1,000 searches. You need no Tavily key and no SearXNG instance of your own.

SpecStream for MorphicAI assistants

What you need

  1. 1. Make a SpecStream key

    In SpecStream, open Agents & API, choose API keys, then Create API key. Turn on Authorize paid work and give the key a Total spending limit. The key is shown once.

  2. 2. Set the two variables in .env.local

    Morphic chooses its search provider from SEARCH_API and reads the SearXNG address from SEARXNG_API_URL. Without SEARCH_API it uses Tavily, its default.

    In .env.local, add these two lines with your key in place of YOUR_SPECSTREAM_KEY. Morphic adds /search and format=json itself, so the address ends at your key. Then start Morphic again with bun dev.

    .env.local
    SEARCH_API=searxng
    SEARXNG_API_URL=https://api.specstream.ai/searxng/YOUR_SPECSTREAM_KEY

  3. 3. With Docker Compose, put them in .env

    Morphic's docker-compose.yaml sets both variables on the morphic service itself: SEARCH_API falls back to searxng and SEARXNG_API_URL to http://searxng:8080, the SearXNG container it starts. Those lines win over .env.local.

    Compose fills them from your shell or from a file named .env beside docker-compose.yaml, and never from .env.local. Put the same two lines in .env, then run docker compose up again. The bundled SearXNG container can keep running. Morphic stops calling it.

    .env (beside docker-compose.yaml)
    SEARCH_API=searxng
    SEARXNG_API_URL=https://api.specstream.ai/searxng/YOUR_SPECSTREAM_KEY

  4. 4. Check it works

    Ask Morphic about something from this week. The answer cites results from the live web that SpecStream returned.

    Each search is in your account's request log with the SearXNG route as its endpoint and its price. GET https://api.specstream.ai/v1/account/requests lists them, newest first.

What changes in Morphic

SettingMorphic todayWith SpecStream
SEARCH_APItavily with bun, searxng with Docker Composesearxng
SEARXNG_API_URLhttp://localhost:8080 in the example file, http://searxng:8080 in Docker Composehttps://api.specstream.ai/searxng/YOUR_SPECSTREAM_KEY
Search keyTAVILY_API_KEY or EXA_API_KEYNone: the key is in the address
BRAVE_SEARCH_API_KEYOptional, for video and image resultsLeave it as it is

What each search costs

Each search Morphic sends to the SearXNG address is one Search API call on the fast tier: $1 per 1,000 searches of up to 10 results, a fifth of the default search's $5. Morphic sends no result count, so each call gets one page of 10 results at that price, and a search that returns nothing costs nothing.

Searches come out of your balance with no quote and no approval. New accounts start with $10 of credit, no card. Questions go to [email protected].

Limits and errors

  • When search is busy, SpecStream answers 429 with a Retry-After header and charges nothing.
  • A key SpecStream does not accept answers 401. Morphic logs SearXNG API error (401): with SpecStream's message. Check the key in the address, and that it can search.
  • A key over its spending limit answers 403. Raise the limit under API keys in Agents & API.

Keep the key private

Morphic calls the SearXNG address from its server, so the key stays in .env.local or .env and never reaches the browser. Keep both files out of git. To end a key's access, revoke it under API keys in Agents & API and make a new one.

Read pages and get rows too

The same key reads pages with the Extract API at $0.80 per 1,000 pages, and a page with no text is not charged. For a dataset, add SpecStream's MCP server at https://api.specstream.ai/mcp and ask for the records in plain words. Deep Search returns every match as structured rows at 5¢, 15¢ or $1 a row, under a maximum you approve. See MCP.

Go back

Remove the two lines, or set SEARCH_API=tavily with a TAVILY_API_KEY, and restart Morphic. Then revoke the key in your workspace if you no longer use it.

More

SpecStream for Morphic covers what it does in Morphic 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].