# AutoSugges

> AutoSugges is a freemium MCP server for developer tools. Autocomplete over reference lists such as countries, NAICS codes and airports, at the edge. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** API, Web, CLI
- **Website:** https://autosugges.com
- **Repository:** https://github.com/autosugges/autosugges-js
- **MCP Registry name:** io.github.autosugges/autosugges-mcp
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-15

## About

AutoSugges publishes a list once as an immutable version and serves every keystroke query from the edge, so lookups never hit your own database. This MCP package, installed from npm as @autosugges/mcp, lets an assistant search a list, browse the catalog and help with setup. Its search_list tool needs a publishable key (pk_live_...) from the free dashboard, and the runtime URL can be overridden.

Platform datasets are free to query on every plan. They include NAICS (2,125 items), countries, airports (4,241), calling codes, cities (37,156), currencies, languages, time zones, top-level domains, U.S. counties and states, SOC 2018, vehicle makes and models, and more, each with its source and licence such as U.S. Census Bureau, CLDR or OurAirports. Your own lists can carry hierarchy, aliases, locales and metadata.

The same service offers a React, React Native and plain HTML component under an MIT-licensed client. Plans are measured in queries per month and have hard limits instead of overage charges: once the allowance runs out the edge returns a quota_exceeded response rather than billing more.

## Features

- **Edge-served lookups:** Queries answer from a published immutable version, not a live database.
- **Free reference datasets:** NAICS, airports, cities, currencies, time zones and more at no extra charge.
- **Hierarchy and aliases:** Lists support parent fill, synonyms, locales and metadata.
- **Origin-restricted keys:** Publishable keys can be limited to your own origins.
- **Hard query limits:** No overage billing; quota_exceeded is returned at the cap.
- **UI components:** React, React Native and plain HTML autocomplete components.

## Good for

- Look up a NAICS code by industry name
- Check an airport or country name against a canonical list
- Prototype an autocomplete field with a free key
- Set up AutoSugges for a project through an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add autosugges-mcp -- npx -y @autosugges/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "autosugges-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@autosugges/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "autosugges-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@autosugges/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "autosugges-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@autosugges/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "autosugges-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@autosugges/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "autosugges-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@autosugges/mcp"
      ]
    }
  }
}
```

## Tools

- `search_list`: Searches a list using a publishable key and returns autocomplete suggestions.

## FAQ

### Do I need a key?

search_list needs a free publishable key from app.autosugges.com.

### What does it cost?

Free covers 25,000 queries a month; Starter is $19, Pro $49, Business $149 and Scale $399 a month.

### Is there overage billing?

No. At the monthly limit the edge returns a quota_exceeded response.

### Which datasets are free?

Platform-published datasets such as NAICS, countries and airports are free to query on every plan.

### Is AutoSugges free?

AutoSugges has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add AutoSugges to Claude Code?

Run this command in your terminal: claude mcp add autosugges-mcp -- npx -y @autosugges/mcp

### What are the best alternatives to AutoSugges?

The closest alternatives to AutoSugges are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/autosugges
