open-index/open-npm huggingface dataset:
npm package: @freeconnect/quickconnect-mcp
Description: MCP server for checking internet service availability at US addresses
Latest version: 1.0.1

# @freeconnect/quickconnect-mcp

> Check internet availability at any US address — directly inside Claude and other AI chat clients.

This is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives AI assistants the ability to look up internet service providers, plans, speeds, and pricing for any US address in real time.

---

## How it works

Once installed, you can ask Claude things like:

> *"What internet options do I have at 123 Main St, Austin, TX 78701?"*

Claude will call the `check_serviceability` tool and return a structured list of available providers, plans, download/upload speeds, and monthly pricing — no copy-pasting, no tab switching.

---

## Requirements

- Node.js 20+
- [Claude Desktop](https://claude.ai/download)
- A QuickConnect API key — contact [FreeConnect](https://freeconnect.us) to get one

---

## Setup

### 1. Edit your Claude Desktop config

**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Add the following:

```json
{
  "mcpServers": {
    "quickconnect": {
      "command": "npx",
      "args": ["-y", "@freeconnect/quickconnect-mcp"],
      "env": {
        "QUICKCONNECT_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

### 2. Restart Claude Desktop

Quit and reopen the app. You'll see a 🔨 hammer icon in the chat input — that confirms the server is connected.

### 3. Ask away

```
What internet providers are available at 25612 Thelmadale Dr, Elkhart, IN 46514?
```

---

## Tool reference

### `check_serviceability`

| Parameter | Type   | Required | Description                          |
|-----------|--------|----------|--------------------------------------|
| `line1`   | string | ✅       | Street address (e.g. "123 Main St")  |
| `line2`   | string | —        | Apt, suite, unit, etc.               |
| `city`    | string | ✅       | City name                            |
| `state`   | string | ✅       | Two-letter state code (e.g. "TX")    |
| `zipCode` | string | ✅       | 5-digit US zip code                  |

---

## Security

- Your API key is passed via environment variable — it is never bundled in the package
- All requests are routed through the FreeConnect API, which handles provider data
- No personal data is stored or logged beyond standard API access logs

---

## License

Private — © FreeConnect. All rights reserved.