# wiswa-mcp

<!-- WISWA-GENERATED-README:START -->

[![Python versions](https://img.shields.io/pypi/pyversions/wiswa-mcp.svg?color=blue&logo=python&logoColor=white)](https://www.python.org/)
[![PyPI - Version](https://img.shields.io/pypi/v/wiswa-mcp)](https://pypi.org/project/wiswa-mcp/)
[![GitHub tag (with filter)](https://img.shields.io/github/v/tag/Tatsh/wiswa-mcp)](https://github.com/Tatsh/wiswa-mcp/tags)
[![License](https://img.shields.io/github/license/Tatsh/wiswa-mcp)](https://github.com/Tatsh/wiswa-mcp/blob/master/LICENSE.txt)
[![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/Tatsh/wiswa-mcp/v0.0.1/master)](https://github.com/Tatsh/wiswa-mcp/compare/v0.0.1...master)
[![CodeQL](https://github.com/Tatsh/wiswa-mcp/actions/workflows/codeql.yml/badge.svg)](https://github.com/Tatsh/wiswa-mcp/actions/workflows/codeql.yml)
[![QA](https://github.com/Tatsh/wiswa-mcp/actions/workflows/qa.yml/badge.svg)](https://github.com/Tatsh/wiswa-mcp/actions/workflows/qa.yml)
[![Tests](https://github.com/Tatsh/wiswa-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/Tatsh/wiswa-mcp/actions/workflows/tests.yml)
[![Coverage Status](https://coveralls.io/repos/github/Tatsh/wiswa-mcp/badge.svg?branch=master)](https://coveralls.io/github/Tatsh/wiswa-mcp?branch=master)
[![Dependabot](https://img.shields.io/badge/Dependabot-enabled-blue?logo=dependabot)](https://github.com/dependabot)
[![Documentation Status](https://readthedocs.org/projects/wiswa-mcp/badge/?version=latest)](https://wiswa-mcp.readthedocs.org/?badge=latest)
[![mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
[![uv](https://img.shields.io/badge/uv-261230?logo=astral)](https://docs.astral.sh/uv/)
[![pytest](https://img.shields.io/badge/pytest-zz?logo=Pytest&labelColor=black&color=black)](https://docs.pytest.org/en/stable/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
[![Downloads](https://static.pepy.tech/badge/wiswa-mcp/month)](https://pepy.tech/project/wiswa-mcp)
[![Stargazers](https://img.shields.io/github/stars/Tatsh/wiswa-mcp?logo=github&style=flat)](https://github.com/Tatsh/wiswa-mcp/stargazers)
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/Tatsh/wiswa-mcp/master.svg)](https://results.pre-commit.ci/latest/github/Tatsh/wiswa-mcp/master)
[![Prettier](https://img.shields.io/badge/Prettier-black?logo=prettier)](https://prettier.io/)

[![@Tatsh](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpublic.api.bsky.app%2Fxrpc%2Fapp.bsky.actor.getProfile%2F%3Factor=did%3Aplc%3Auq42idtvuccnmtl57nsucz72&query=%24.followersCount&label=Follow+%40Tatsh&logo=bluesky&style=social)](https://bsky.app/profile/Tatsh.bsky.social)
[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Tatsh-black?logo=buymeacoffee)](https://buymeacoffee.com/Tatsh)
[![Libera.Chat](https://img.shields.io/badge/Libera.Chat-Tatsh-black?logo=liberadotchat)](irc://irc.libera.chat/Tatsh)
[![Mastodon Follow](https://img.shields.io/mastodon/follow/109370961877277568?domain=hostux.social&style=social)](https://hostux.social/@Tatsh)
[![Patreon](https://img.shields.io/badge/Patreon-Tatsh2-F96854?logo=patreon)](https://www.patreon.com/Tatsh2)

<!-- WISWA-GENERATED-README:STOP -->

FastMCP server exposing [Wiswa](https://github.com/Tatsh/wiswa) settings discovery to AI
assistants such as Claude Code, Cursor, and GitHub Copilot.

## Installation

```shell
pipx install wiswa-mcp
```

## Usage

```shell
wiswa-mcp
```

The server publishes the following MCP tools:

- `get_defaults` — return resolved default settings, optionally narrowed to a dot-separated key
  path.
- `lookup_setting` — return a single setting's default value plus a ready-to-paste
  `.wiswa.jsonnet` override snippet.
- `list_settings` — enumerate the keys available at a given path and depth.
- `search_settings` — substring search across fully-qualified setting key paths.

### Claude Code

```shell
claude mcp add wiswa-mcp -- wiswa-mcp
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "wiswa-mcp": {
      "command": "wiswa-mcp"
    }
  }
}
```

### GitHub Copilot CLI

Add to `.github/copilot/mcp.json`:

```json
{
  "mcpServers": {
    "wiswa-mcp": {
      "command": "wiswa-mcp"
    }
  }
}
```