Metadata-Version: 2.4
Name: namefinder-mcp
Version: 0.1.0
Summary: MCP server for NameFinder — let AI agents generate available, brandable domain names and check availability, pricing, and social handles in-loop.
Project-URL: Homepage, https://namefinder.dev
Project-URL: Repository, https://github.com/workollab/namefinder
Author: Workollab
License-Expression: MIT
License-File: LICENSE
Keywords: agent,availability,domain,domains,mcp,model-context-protocol,namefinder,naming,rdap
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: Name Service (DNS)
Requires-Python: >=3.10
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

# namefinder-mcp

An [MCP](https://modelcontextprotocol.io) server that lets AI agents use
[NameFinder](https://namefinder.dev) in-loop: generate available, brandable
domain names and check availability, registrar pricing, and social handles. A
thin client of the NameFinder HTTP API, over stdio.

## MCP client configuration

No install step — `uvx` fetches and runs it on demand:

```json
{
  "mcpServers": {
    "namefinder": {
      "command": "uvx",
      "args": ["namefinder-mcp"]
    }
  }
}
```

By default it talks to the hosted API at `https://namefinder.dev`. To point it at
a local dev server, add an env override:

```json
"env": { "NAMEFINDER_API_URL": "http://localhost:4000" }
```

## Tools

- `generate_names` — generate and verify ranked, available names (with grades + pricing).
- `check_domain` — check one complete domain's availability + price.
- `check_all_tlds` — check a label across supported TLDs.
- `check_socials` — check a handle across supported social platforms.

## Develop

```sh
uv run namefinder-mcp          # runs the stdio server
```

## License

MIT
