Metadata-Version: 2.4
Name: osf-agentkit
Version: 0.1.0
Summary: Coinbase AgentKit action provider for OSF (Open Source Filings): provenance-stamped sanctions, entity, and CVE data for AI agents, paid per call over x402 (USDC on Base).
Project-URL: Homepage, https://api.osf-master-server.com
Project-URL: Source, https://github.com/onefreeman1337/osf-agentkit
Author: Corey Gallant
License: MIT
Keywords: agentkit,ai-agents,coinbase,cve,entity-resolution,kyb,kyc,ofac,provenance,sanctions,x402
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: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: coinbase-agentkit>=0.7.0
Requires-Dist: x402<2.0.0,>=1.0.0
Description-Content-Type: text/markdown

# osf-agentkit

A [Coinbase AgentKit](https://github.com/coinbase/agentkit) action provider for **OSF (Open Source Filings)**: provenance-stamped, public-domain U.S. government and scientific data for AI agents, paid per call over **x402** (USDC on Base mainnet).

Three tools, each returning structured JSON with a provenance URL to the authoritative primary source:

- **OSF_lookup_entity** ($0.01) - resolve/verify a company or person against public registries (CMS NPI, GLEIF LEI, FDIC, SEC EDGAR). For KYC, KYB, counterparty due-diligence.
- **OSF_screen_entity** ($0.05) - sanctions screening against OFAC SDN, EU, and UK OFSI lists. Returns hit/no-hit, matched list, and an audit receipt. For AML/KYC.
- **OSF_check_cve_exploited** ($0.02) - is a CVE actively exploited (CISA KEV), plus EPSS probability and CVSS severity. For vulnerability management and DevSecOps.

Payment is automatic: on an HTTP 402 the x402 client signs and settles the USDC micropayment with the agent's own EVM wallet, then retries. Each action enforces a per-call spend ceiling.

## Install

```
pip install osf-agentkit
```

## Use

```python
from coinbase_agentkit import AgentKit, AgentKitConfig
from osf_agentkit import osf_action_provider

agent_kit = AgentKit(AgentKitConfig(
    wallet_provider=your_evm_wallet_provider,
    action_providers=[osf_action_provider()],
))
```

The agent's wallet must hold USDC on Base mainnet. Learn more at the [OSF data marketplace](https://api.osf-master-server.com/mcp).

## License

MIT
