English Français العربية

AutoSugges

Official registry Other

Autocomplete over edge-served reference lists (countries, NAICS, airports), plus catalog and setup.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @autosugges/mcp
Claude Code 
claude mcp add autosugges -e 'AUTOSUGGES_PUBLISHABLE_KEY=<AUTOSUGGES_PUBLISHABLE_KEY>' -e 'AUTOSUGGES_RUNTIME_URL=https://runtime.autosugges.com' -- npx -y @autosugges/mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "autosugges": {
            "command": "npx",
            "args": [
                "-y",
                "@autosugges/mcp@0.1.1"
            ],
            "env": {
                "AUTOSUGGES_PUBLISHABLE_KEY": "<AUTOSUGGES_PUBLISHABLE_KEY>",
                "AUTOSUGGES_RUNTIME_URL": "https://runtime.autosugges.com"
            }
        }
    }
}

Environment variables

  • AUTOSUGGES_PUBLISHABLE_KEY Publishable key (pk_live_...) for the list to search. Free at https://app.autosugges.com. Required for search_list.
  • AUTOSUGGES_RUNTIME_URL Runtime origin.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @autosugges/client
  2. React / Next.js
  3. Expo / React Native
  4. Plain HTML
  5. Entry points

@autosugges/client

AutoSugges: edge autocomplete API + free reference datasets (countries, NAICS, airports, currencies…) behind one React / React Native / HTML component.

Docs: https://docs.autosugges.com · Datasets: https://autosugges.com

npm i @autosugges/client

Replace YOUR_PUBLISHABLE_KEY with a free key from https://app.autosugges.com — one key per list, locked to your site's origins. Publishable keys are safe in a browser.

React / Next.js

'use client';
import { useState } from 'react';
import { AutoSugges } from '@autosugges/client/react';
import { AutosuggesProvider, type AutoSuggesValue } from '@autosugges/client/react-core';

export function CountryField() {
  const [country, setCountry] = useState<AutoSuggesValue>(null);
  return (
    <AutosuggesProvider lists={{ countries: 'YOUR_PUBLISHABLE_KEY' }}>
      <AutoSugges list="countries" value={country} onChange={setCountry} />
    </AutosuggesProvider>
  );
}

value is the full selected item (an array for multi-select lists). Behaviour — minimum characters, debounce, creatable items, multi-select — comes from the list's server policy; overrides can only narrow it.

Expo / React Native

import { AutoSugges } from '@autosugges/client/native-ui';
import { AutosuggesProvider } from '@autosugges/client/react-core';
// same props as web: <AutoSugges list="countries" value={value} onChange={setValue} />

Optional peers for the bottom-sheet presentation: @gorhom/bottom-sheet, react-native-gesture-handler, react-native-reanimated.

Plain HTML

<script src="https://cdn.jsdelivr.net/npm/@autosugges/client/dist/browser/autosugges.js"></script>
<input
  data-autosugges-key="YOUR_PUBLISHABLE_KEY"
  data-autosugges-base-url="https://runtime.autosugges.com"
  data-autosugges-placeholder="Country"
/>

Self-hosted copy with an SRI hash: https://autosugges.com/sdk/v1/autosugges.js. Other attributes: data-autosugges-theme (light|dark), -locale, -label, -parent, -access-token. Call window.AutoSugges.autoInit() after injecting markup later.

Entry points

. (client, combobox state machine) · ./react · ./react-core · ./native · ./native-ui · ./browser. Style it with CSS custom properties (--as-color-text, --as-font-sans, …); see the docs.

MIT © AKHBaig

Frequently asked questions

What is AutoSugges?

Autocomplete over edge-served reference lists (countries, NAICS, airports), plus catalog and setup.

How do I install AutoSugges?

It runs on your machine. In Claude Code: claude mcp add autosugges -e 'AUTOSUGGES_PUBLISHABLE_KEY=<AUTOSUGGES_PUBLISHABLE_KEY>' -e 'AUTOSUGGES_RUNTIME_URL=https://runtime.autosugges.com' -- npx -y @autosugges/mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does AutoSugges need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is AutoSugges open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains AutoSugges?

It is published by autosugges. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.