Metadata-Version: 2.4
Name: nummeropslag-mcp
Version: 1.0.1
Summary: MCP server for Danish phone-number lookup, caller ID and spam signals — official CVR + number-register data (nummeropslag.dk)
Author-email: Nummeropslag <info@lynbro.dk>
License: MIT
Project-URL: Homepage, https://nummeropslag.dk
Project-URL: Repository, https://github.com/andrey-tut/nummeropslag-api
Project-URL: Documentation, https://andrey-tut.github.io/nummeropslag-api/
Project-URL: Get an API key, https://nummeropslag.dk/api-noegle
Keywords: mcp,model-context-protocol,caller-id,phone-lookup,denmark,cvr,spam,nummeropslag
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Communications :: Telephony
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]<2,>=1.2
Requires-Dist: httpx<1,>=0.27

# nummeropslag-mcp

MCP (Model Context Protocol) server that gives AI agents — Claude Desktop, Claude Code,
or any MCP client — access to **Danish phone-number data** from
[nummeropslag.dk](https://nummeropslag.dk): company lookup from the official **CVR**
business register, telecom **operator** + number type from the Danish number register,
and a community **spam/scam verdict**.

## Install & run

```bash
pip install nummeropslag-mcp        # or: uvx nummeropslag-mcp
export NUMMEROPSLAG_API_KEY=npk_xxx # get a key: https://nummeropslag.dk/api-noegle
nummeropslag-mcp                    # stdio transport
```

Claude Desktop / Claude Code config:

```json
{
  "mcpServers": {
    "nummeropslag": {
      "command": "nummeropslag-mcp",
      "env": { "NUMMEROPSLAG_API_KEY": "npk_xxx" }
    }
  }
}
```

## Tools

| Tool | Description |
|---|---|
| `lookup_number(number)` | Full record: company (CVR), operator, spam/trust, comments |
| `check_spam(number)` | Compact spam/scam verdict (caller-ID style) |
| `get_operator(number)` | Operator + number type only |
| `search_businesses(query, limit)` | Find Danish companies by name (CVR) |
| `api_status()` | Your key's scopes + quota usage |

Docs & examples: <https://github.com/andrey-tut/nummeropslag-api> ·
API reference: <https://andrey-tut.github.io/nummeropslag-api/>
