Metadata-Version: 2.4
Name: klawsearch-mcp
Version: 0.1.0
Summary: MCP server for KlawSearch — agent-ready search and extract tools for Claude Desktop, Goose, and Cursor
Project-URL: Homepage, https://klawsearch.com
Project-URL: Documentation, https://klawsearch.com/docs
Author: KlawSearch
License: MIT
License-File: LICENSE
Keywords: agents,ai,claude,cursor,goose,llm,mcp,model-context-protocol,rag,retrieval,search
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: klawsearch>=0.1.0
Requires-Dist: mcp>=1.0
Description-Content-Type: text/markdown

# klawsearch-mcp

MCP server for [KlawSearch](https://klawsearch.com) — gives MCP-compatible agents
(Claude Desktop, Goose, Cursor, OpenClaw) a search tool that returns clean,
ranked, agent-ready results instead of raw links.

```bash
pip install klawsearch-mcp
```

Get a free API key at [klawsearch.com](https://klawsearch.com) (1,000 requests/month,
no card required).

## Tools exposed

| Tool | What it does |
|---|---|
| `klawsearch_search` | Ranked results + an optional synthesized, source-cited answer |
| `klawsearch_extract` | Fetch a URL and return cleaned, LLM-ready text |

## Claude Desktop

`~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "klawsearch": {
      "command": "klawsearch-mcp",
      "env": { "KLAWSEARCH_API_KEY": "ks-live-..." }
    }
  }
}
```

## Goose

`~/.config/goose/config.yaml`:

```yaml
extensions:
  klawsearch:
    type: stdio
    cmd: klawsearch-mcp
    envs:
      KLAWSEARCH_API_KEY: ks-live-...
```

## Configuration

| Env var | Required | Default |
|---|---|---|
| `KLAWSEARCH_API_KEY` | yes | — |
| `KLAWSEARCH_BASE_URL` | no | `https://api.klawsearch.com` |

Point `KLAWSEARCH_BASE_URL` at your own instance if you self-host KlawSearch.

## Why KlawSearch

Built for agents rather than people: hybrid retrieval (BM25 + vector + RRF),
grounded answers with citations, SEC/EDGAR financial filings the general-purpose
search APIs don't index, and a stack you can self-host.

- Website: https://klawsearch.com
- Python SDK: [`klawsearch`](https://pypi.org/project/klawsearch/)

MIT licensed.
