Metadata-Version: 2.3
Name: karon-mcp
Version: 1.8.4
Summary: Karon API MCP server for Claude, Cursor, and other MCP clients. Retrieve web content from MCP-compatible tools.
Project-URL: Homepage, https://karonlabs.net/api/
Project-URL: Documentation, https://karonlabs.net/api/docs.html
Author-email: Karon Labs <ceo@karonlabs.net>
License: MIT
Keywords: claude,cursor,mcp,retrieval,web-content
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# karon-mcp

MCP server for the Karon API.

Karon MCP 1.8.4 exposes two tools:

- `browse(url, output_format="markdown", readability=True)` - retrieve one URL as markdown, text, or HTML. If the first upstream attempt is blocked or returns empty content, it retries once automatically.
- `credits()` - show account credit and tier information.

Field-based JSON output is available through the Karon API directly, not this MCP package.

## Agent guidance

Use one single URL for one user intent. For threads or listing pages, prefer the original page or one aggregate endpoint before requesting child URLs. Avoid fan-out across child item APIs unless the user explicitly asks for multiple individual URLs.

For Hacker News threads, prefer `https://hn.algolia.com/api/v1/items/{id}` or the HN item page instead of repeated Firebase child item requests.

## Install

```bash
uvx karon-mcp
```

or:

```bash
pip install karon-mcp
```

## Configuration

Set `KARON_API_KEY` in your MCP client environment.

## Links

- API Documentation: https://karonlabs.net/api/docs.html
