Autom

dev.automPublished by autom.devOfficial publisherv0.1.0Updated Nov 7, 2026

Google, Bing and Brave search results as structured JSON — web, maps, news, shopping, images, jobs…

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

Wraps the Autom SERP API so an assistant can run Google, Bing, Brave, DuckDuckGo and Yahoo searches and get structured JSON results.

What you can do
  • Search the web across Google, Bing, Brave, DuckDuckGo and Yahoo, or with one call that walks engines in order
  • Search verticals: Google Maps places, Google News, Google Shopping products, Google Jobs listings, images and videos
  • Query Google AI Mode and get text blocks, references and shopping results
  • Get Google autocomplete suggestions and look up supported Google countries, languages and locations
  • Check account credit balance and usage, plus per-engine infrastructure health
When to use it
Useful when an assistant needs live web, news, shopping, jobs or local-place results as structured data rather than page text, or when you want one key covering several search engines.
Requirements
An Autom API key, sent as the x-api-key header for the hosted endpoint or as AUTOM_API_KEY for the local package. The local package needs Node.js 20 or newer; the hosted server at mcp.autom.dev needs nothing installed. OAuth is also declared for authentication.
Before you install
Every tool that calls the API consumes credits, so usage has a cost tied to your Autom account. The API key is a secret and should be kept out of shared configs. Fetched web content is untrusted and may contain injected instructions. The stats tool is not scoped to your account and may require activation.

Installation

In SourceWeft

  1. Open Autom in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.autom%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "autom": {
      "type": "http",
      "url": "https://mcp.autom.dev/"
    }
  }
}

README

Autom MCP Server

Official Model Context Protocol server for the Autom SERP API.

Google, Bing and Brave search results as structured JSON — web, maps, news, shopping, images, jobs and AI Mode.

It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).

Requirements

  • Node.js 20 or newer
  • a Autom API key — sign up, then copy it from the dashboard

Hosted server (recommended)

Autom runs this server for you at https://mcp.autom.dev/ (Streamable HTTP). Send your API key in the x-api-key header; nothing to install.

sh
claude mcp add --transport http autom https://mcp.autom.dev/ --header "x-api-key: YOUR_API_KEY"
json
{  "mcpServers": {    "autom": {      "url": "https://mcp.autom.dev/",      "headers": {        "x-api-key": "YOUR_API_KEY"      }    }  }}

The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.

Run it locally

Claude Code

sh
claude mcp add autom --env AUTOM_API_KEY=YOUR_API_KEY -- npx -y @automdev/mcp

Claude Desktop, Cursor, Windsurf and other clients

Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):

json
{  "mcpServers": {    "autom": {      "command": "npx",      "args": ["-y", "@automdev/mcp"],      "env": {        "AUTOM_API_KEY": "YOUR_API_KEY"      }    }  }}

VS Code

json
{  "servers": {    "autom": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@automdev/mcp"],      "env": {        "AUTOM_API_KEY": "${input:autom-api-key}"      }    }  },  "inputs": [    {      "type": "promptString",      "id": "autom-api-key",      "description": "Autom API key",      "password": true    }  ]}

Claude Desktop extension

Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.

Docker

sh
docker build -t autom-mcp .docker run -i --rm -e AUTOM_API_KEY=YOUR_API_KEY autom-mcp

Tools

ToolDescription
bing_searchQuery Bing Search via API and retrieve structured organic results (title, link, snippet, position).
brave_imagesSearch Brave Images via API and retrieve structured image results with pagination and SafeSearch.
brave_searchSearch Brave Search via API and retrieve structured organic results with pagination.
brave_videosSearch Brave Videos via API and retrieve structured video results with pagination and SafeSearch.
duckduckgo_searchQuery DuckDuckGo via API and retrieve structured organic results with region and language.
finder_google_countriesSearch Google countries and retrieve country codes (free Finder endpoint).
finder_google_languagesSearch Google languages and retrieve language codes (free Finder endpoint).
finder_google_locationsFind supported Google locations and retrieve location IDs and country codes (free endpoint).
google_imagesSearch Google Images via API and retrieve image results (URLs, titles, sources, dimensions).
google_jobsScrape Google Jobs results via API and retrieve structured job listings with title, company, location, and pagination.
google_mapsSearch Google Maps via API and retrieve structured place results (address, website, phone).
google_newsSearch Google News via API and retrieve structured news results with pagination.
google_searchScrape Google Search results via API and retrieve structured SERP data with pagination.
google_search_aiQuery Google AI Mode via API. JSON with text_blocks, references, and shopping_results.
google_search_autocompleteGet Google Search autocomplete suggestions via API for a given query.
google_search_lightScrape lightweight Google Search results via API: fast, cost-efficient, organic results only.
google_shoppingScrape Google Shopping results via API and retrieve structured product listings with prices, ratings, and merchant data.
google_videosSearch Google Videos via API and retrieve structured video results with metadata.
searchOne call walks engines in order and returns the first organic results. engines=auto tries Google, then Brave, Bing, DuckDuckGo, Yahoo, and Baidu. Omitted gl is us and omitted hl is en. There is no pa…
statsInfrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per account: HTTP 403 means contact support to activate it.
usageRetrieve real-time usage statistics and credit balance for your Autom account.
yahoo_searchQuery Yahoo via API and retrieve structured organic results with country and language.

Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.

Streamable HTTP

sh
npx @automdev/mcp --http --port 3000

The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.

createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):

ts
import { createHttpHandler } from "@automdev/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

Security

  • The API key is read from AUTOM_API_KEY (stdio) or the request headers (HTTP) and removed from error messages.
  • Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
  • See SECURITY.md to report a vulnerability.

Development

sh
npm installnpm testnpm run buildnpx @modelcontextprotocol/inspector node dist/stdio.js

Built on the SDK

The server uses the official Node.js SDK (@automdev/sdk).

All Autom SDKs

SDKPackageInstall
Node.js@automdev/sdknpm install @automdev/sdk
Pythonautomdevpip install automdev
Goautom-gogo get github.com/automdev/autom-go
.NETAutomdotnet add package Autom
Rubyautomgem install autom
PHPautom/sdkcomposer require autom/sdk
Javaautom-javabuild from source, see its README
CLI@automdev/clinpm install -g @automdev/cli
MCP server@automdev/mcpnpx -y @automdev/mcp

License

MIT — see LICENSE.

Source: README.md at commit 3cc6bf8

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.1.0LatestNov 7, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts