Metadata-Version: 2.4
Name: kynth-crewai
Version: 0.5.0
Summary: Kynth Core tools for CrewAI — document parsing, chargebacks, contracts, dunning, lead screening, and cited research as ready-made BaseTools.
Project-URL: Homepage, https://api.kynth.studio
Project-URL: Documentation, https://api.kynth.studio/docs
Project-URL: Source, https://github.com/kyisaiah47/kynth
Author: Kynth Studios
License: MIT
Keywords: agent,ai,chargeback,contract,crewai,document-parsing,kynth,llm,tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: kynth>=0.4.0
Provides-Extra: crewai
Requires-Dist: crewai>=0.86.0; extra == 'crewai'
Description-Content-Type: text/markdown

# kynth-crewai

**[Kynth Core](https://api.kynth.studio)** tools for [CrewAI](https://www.crewai.com) — parse documents, fight chargebacks, analyze contracts, match POs, screen leads, and run cited research from inside your crew.

Every tool is a thin `BaseTool` over the official [`kynth`](https://pypi.org/project/kynth/) SDK: auth, timeouts, and typed errors behave exactly like a direct client call, and failed calls never burn credits. Each tool's description carries its exact price, so cost-aware agents can budget calls. The full machine-readable rate card lives at [api.kynth.studio/pricing.json](https://api.kynth.studio/pricing.json).

## Install

```bash
pip install kynth-crewai crewai        # or: pip install "kynth-crewai[crewai]"
```

Get a key (and 500 free credits every month, no card) at **[api.kynth.studio](https://api.kynth.studio)**.

## Use

```python
from crewai import Agent
from kynth_crewai import kynth_tools

agent = Agent(
    role="AR analyst",
    goal="Get overdue invoices paid",
    backstory="…",
    tools=kynth_tools(api_key="ksk_live_..."),  # or set KYNTH_API_KEY
)
```

Or pick individual tools (and share one client):

```python
from kynth import Kynth
from kynth_crewai import KynthChargebackTool, KynthDunningTool

client = Kynth(api_key="ksk_live_...")
tools = [KynthChargebackTool(client=client), KynthDunningTool(client=client)]
```

## Tools

| Tool | What it does |
| --- | --- |
| `kynth_chargeback` | Dispute details → representment narrative, evidence checklist, win likelihood |
| `kynth_compare` | Two document versions → every material change + risk notes |
| `kynth_contract` | Contract → parties, term, renewal, obligations, risk flags |
| `kynth_statement` | Bank/card statement → normalized transactions |
| `kynth_po_match` | Invoice vs PO vs receipt → 3-way match + discrepancies |
| `kynth_dunning` | Overdue invoice → escalation-appropriate collection sequence |
| `kynth_screen` | Lead + your ICP → web-grounded qualification verdict |
| `kynth_research` | Company/topic → multi-source, citation-backed brief |
| `kynth_parse` | Any document (PDF/image/text) → structured, validated JSON |
| `kynth_tables` | Any document → every table as clean headers + rows |

Document tools accept `file_url`, raw `text`, or `file_base64` + `file_mime_type`.

Also available: the [TypeScript SDK](https://www.npmjs.com/package/@kynth/api), [Vercel AI SDK / LangChain tools](https://www.npmjs.com/package/@kynth/ai-tools), and the [MCP server](https://www.npmjs.com/package/@kynth/api-mcp).
