Metadata-Version: 2.4
Name: gocreative-wedge-mcp
Version: 1.1.0
Summary: Fiat-billed MCP server for AI agents: OFAC/PEP/watchlist sanctions screening, KYB, company + people enrichment, prospect/vendor/onboard 360 diligence bundles, intent-based lead search, securities-reference-360 (ISIN -> listings + FIGIs), LEI -> issued ISINs, domain trust score, and GLEIF fund relationships. Pay with a card — no crypto wallet. Free demo tools, no key.
Author: GoCreative
License: MIT
Project-URL: Homepage, https://api.gocreativeai.com
Project-URL: Documentation, https://api.gocreativeai.com/pricing
Project-URL: Free demo, https://api.gocreativeai.com/demo/sanctions-screen/Gazprom
Keywords: mcp,model-context-protocol,mcp-server,agent-tools,ofac,sanctions,sanctions-screening,aml,kyc,kyb,pep,compliance,watchlist,sdn,opensanctions,due-diligence,regtech,company-enrichment,people-enrichment,lead-generation,sales-intelligence,fiat,stripe,pay-per-call,openfigi,figi,securities-reference,isin,lei,gleif,lei-to-isin,fund-manager,domain-trust,reference-data
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
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 :: Office/Business :: Financial
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.2.0
Requires-Dist: httpx>=0.27
Provides-Extra: http
Requires-Dist: uvicorn>=0.30; extra == "http"
Requires-Dist: starlette>=0.37; extra == "http"
Dynamic: license-file

<!-- mcp-name: io.github.colinhughes2121/gocreative-wedge-mcp -->

# gocreative-wedge-mcp

**Fiat-billed compliance, enrichment & lead tools for AI agents — over MCP.**

A [Model Context Protocol](https://modelcontextprotocol.io) server that gives any
MCP client (Claude Desktop, Cursor, Claude Code, custom agents) a sharp toolkit for
**KYC/KYB, sanctions screening, company + people enrichment, due-diligence bundles,
and intent-based lead search** — backed by real OpenSanctions / firmographic /
enrichment data from the GoCreative API.

Billing is **fiat**: the MCP marketplace charges the subscriber's card/subscription,
or you supply a card-funded `gck_` credit key. **No crypto wallet, no on-chain
payment.** The free `list_wedge_tools` and `pricing_info` tools — plus 5 demo
calls/day/IP on the tools that expose a demo — work with **no key at all**, so you
can try it immediately.

---

## Install

```bash
pip install gocreative-wedge-mcp
```

Requires Python ≥ 3.10. Pulls `mcp` and `httpx`. (The hosted HTTP transport is
optional: `pip install "gocreative-wedge-mcp[http]"`.)

Run it directly to sanity-check (stdio; Ctrl-C to stop):

```bash
gocreative-wedge-mcp          # or:  python -m gocreative_wedge_mcp
```

---

## Tools (10)

| Tool | Arg | Price (USD) | Free demo | What it does |
|---|---|---|---|---|
| `screen_sanctions` | `name` | $0.45 | ✅ | OFAC/EU/UK/UN + PEP + 100+ watchlists screen (OpenSanctions). The KYC/KYB gate. |
| `kyb` | `company` | $0.45 | ✅ | Full KYB / counterparty-risk verdict: sanctions + PEP + risk score + registry + legal exposure + firmographics. |
| `enrich_company` | `domain` | $0.05 | ✅ | Company firmographics from a domain: industry, size, founded, logo, socials. |
| `people_enrich` | `query` | $0.15 | — | Verified work email + phone + LinkedIn from `"Full Name@domain.com"`. |
| `prospect_360` | `company` | $0.10 | — | Sales-prospect 360: firmographics + domain intel + intent signals. |
| `vendor_360` | `company` | $0.45 | — | Third-party-risk 360: sanctions + risk score + KYB dossier + firmographics. |
| `onboard_360` | `company` | $0.45 | — | Customer-onboarding 360: sanctions/PEP + KYB verdict + firmographics. |
| `leads_search` | `keyword` | $0.05 | — | Companies by intent signal (funding / federal contract / grant / FDA clearance). |
| `list_wedge_tools` | — | **free** | ✅ | List every tool with price + demo flag. Call first. |
| `pricing_info` | — | **free** | ✅ | Fiat pricing + how billing works. |

Prices are surfaced to marketplaces and via `pricing_info`; the marketplace (or your
`gck_` credit key) settles them.

---

## Billing / auth (three modes, auto-selected)

1. **`GOCREATIVE_API_KEY=gck_...`** → sent as `Authorization: Bearer gck_...`. Decrements
   a Stripe-funded dollar ledger server-side and returns real data. Buy a key with a
   card at <https://api.gocreativeai.com/credits/buy>. *This is the primary fiat rail.*
2. **`GOCREATIVE_RAPIDAPI_SECRET=...`** → sent as `X-RapidAPI-Proxy-Secret`; the proxy
   bills the subscriber.
3. **No key** → free `/demo/<tool>/<arg>` path (5 calls/day/IP) so preview + the meta
   tools always return real data.

Other env vars: `GOCREATIVE_BASE_URL` (default `https://api.gocreativeai.com`),
`GOCREATIVE_HTTP_TIMEOUT` (default 60s), `TRANSPORT` (`stdio` default | `streamable-http`),
`MCP_PORT` (default 4023, http only), `GOCREATIVE_ANALYTICS_DB` (override local usage log).

---

## MCP client config

### Claude Desktop / Cursor / Claude Code (`mcpServers`)

Add to your MCP config (e.g. `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "gocreative-wedge": {
      "command": "gocreative-wedge-mcp",
      "env": {
        "GOCREATIVE_API_KEY": "gck_your_card_funded_key_optional"
      }
    }
  }
}
```

Omit `env` entirely to run in free-demo mode (the meta tools + 5 demo calls/day work
with no key). If `gocreative-wedge-mcp` isn't on PATH, use the module form:

```json
{
  "mcpServers": {
    "gocreative-wedge": {
      "command": "python",
      "args": ["-m", "gocreative_wedge_mcp"],
      "env": { "GOCREATIVE_API_KEY": "gck_..." }
    }
  }
}
```

### Hosted (streamable-http)

```bash
TRANSPORT=streamable-http MCP_PORT=4023 gocreative-wedge-mcp
# then point an MCP client at http://127.0.0.1:4023/mcp
```

Requires the `[http]` extra: `pip install "gocreative-wedge-mcp[http]"`.

---

## Example

```
> list_wedge_tools()
> screen_sanctions(name="Gazprom")
  → { "flagged": true, "match_count": 6, "risk_topics": [...], "matches": [...] }
> kyb(company="Stripe")
> people_enrich(query="Patrick Collison@stripe.com")
```

---

## License

MIT © GoCreative. Data via the GoCreative API (OpenSanctions and partner sources).
