Metadata-Version: 2.4
Name: omniventure-tools
Version: 1.0.0
Summary: Sub-15ms edge intelligence tools for Claude Desktop, Cursor, LangChain, and autonomous AI agents.
Author-email: OmniVenture Fleet <dalnaspidal@gmail.com>
License: MIT
Project-URL: Homepage, https://omniventure-api.web.app
Project-URL: Documentation, https://omniventure-api.web.app
Project-URL: Repository, https://github.com/dalnaspdal/omniventure-agent-tools
Keywords: mcp,model-context-protocol,claude,cursor,langchain,token-compression,json-repair,pii-redaction
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.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0
Dynamic: license-file

# OmniVenture Edge Agent Tools (MCP & LangChain)

> **Sub-15ms edge intelligence tools for Claude Desktop, Cursor, LangChain, and autonomous AI agents.**
> Reduce LLM prompt context tokens by up to 90%, repair malformed JSON in <1ms, and enforce privacy boundaries on bare-metal dual Xeon edge infrastructure.
>
> 🌐 **Canonical Developer Hub & Agent Discovery**: [https://omniventure-api.web.app](https://omniventure-api.web.app)

---

## 🚀 Key Advantages for AI Agents

| Tool | Capability | Token / Latency Advantage |
| :--- | :--- | :--- |
| **`extract_markdown`** | Scrapes web URLs or parses raw HTML into dense, clean Markdown without boilerplate. | **Cuts context tokens by 80% to 95%** (e.g. converts 60KB HTML into ~800 clean tokens). Sub-15ms. |
| **`repair_json`** | Fixes malformed JSON emitted by LLMs (code fences, single quotes, trailing commas, Python literals). | **0.37ms edge execution**. Saves 100% tokens and 2–5s latency vs re-prompting. |
| **`sanitize_pii`** | Redacts emails, phone numbers, payment cards, and SSNs before sending data to external public LLMs. | Sub-5ms regex masking. Enforces GDPR, HIPAA, and DLP boundaries. |
| **`distill_context`** | Extracts dense structured entities, financial metrics, and top keywords from documents. | Compresses 5,000+ words into ~150 structured tokens (>95% compression). |
| **`verify_email`** | Validates RFC 5322 syntax, verifies live DNS MX records, and flags burner/temporary domains. | Sub-15ms direct DNS MX check. Zero third-party SaaS rate limits. |
| **`lookup_ip`** | Resolves IP routing taxonomy, private/loopback CIDRs, and reverse PTR hostnames. | Sub-5ms native socket resolution. |

---

## ⚡ Quickstart: Claude Desktop

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "omniventure-agent-tools": {
      "command": "python3",
      "args": ["-m", "distribution.mcp.client_agent_mcp"],
      "env": {
        "OMNIVENTURE_GATEWAY_URL": "https://automatically-welcome-dad-extensive.trycloudflare.com",
        "RAPIDAPI_KEY": "<YOUR_RAPIDAPI_KEY>"
      }
    }
  }
}
```

---

## ⚡ Quickstart: Cursor IDE

In Cursor: **Settings** → **Features** → **MCP Servers** → **Add New MCP Server**:
- **Name**: `omniventure-edge`
- **Type**: `command`
- **Command**: `python3 -m distribution.mcp.client_agent_mcp`

---

## ⚡ Quickstart: LangChain & Python

```python
from distribution.python_sdk.omniventure_tools import (
    create_markdown_tool,
    create_json_repair_tool,
    create_pii_sanitizer_tool
)

# 1. Instantiate drop-in LangChain tools
tools = [
    create_markdown_tool(api_key="YOUR_RAPIDAPI_KEY").as_langchain_tool(),
    create_json_repair_tool(api_key="YOUR_RAPIDAPI_KEY").as_langchain_tool(),
    create_pii_sanitizer_tool(api_key="YOUR_RAPIDAPI_KEY").as_langchain_tool()
]

# 2. Attach to your LangChain / CrewAI / smolagents agent
# agent = create_react_agent(llm, tools=tools)
```

---

## ⚡ Native RapidAPI Remote MCP Gateway

If you prefer not running local Python scripts, you can connect directly to RapidAPI's hosted MCP proxy:

```bash
npx mcp-remote https://mcp.rapidapi.com \
  --header "x-api-host: omniventure-m2m-micro-utilities.p.rapidapi.com" \
  --header "x-api-key: <YOUR_RAPIDAPI_KEY>"
```

---

## 💳 Settlement & Pricing

- Endpoints are priced at **£0.01 to £0.04 GBP per request**.
- Supported rails:
  - **Credit Card via RapidAPI**: Monthly metered billing settled to PayPal.
  - **HTTP 402 / L402 Lightning**: Direct programmatic preimage tokens for crypto-native agent swarms.

Marketplace Listing: [RapidAPI Hub - OmniVenture M2M Micro-Utilities](https://rapidapi.com/dalnaspidal/api/omniventure-m2m-micro-utilities)
