io.github.NexusFeed/nexusfeed-abc
US liquor license compliance records (CA, TX, NY, FL, IL) with verifiable provenance.
Open source Open in the app JSON README (API)
About
US liquor license compliance records (CA, TX, NY, FL, IL) with verifiable provenance.
Details
- Kind
- MCP servers
- Topic
- Security & identity
- Publisher
- nexusfeed
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.1.1
- Stars
- 1
- Last push
- 2026-04-15T21:54:09Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:02:08
- Updated
- 2026-08-29 03:02:08
- Origin id
io.github.NexusFeed/nexusfeed-abc
README
# nexusfeed-mcp
[](https://pypi.org/project/nexusfeed-mcp/)
[](https://www.python.org/downloads/)
[](LICENSE)
Real-time LTL freight fuel surcharge rates and US state ABC liquor license compliance records — served as normalized, verifiable JSON for AI agents via the Model Context Protocol.
Data is extracted from carrier tariff pages and state ABC portals (JS-rendered, CAPTCHAs, session state) that are structurally inaccessible to raw LLM browsing. Every response includes a `_verifiability` block — extraction timestamp, confidence score, and source URL — so agents can assess data quality before acting.
## Tools
| Tool | Description |
|------|-------------|
| `ltl_get_fuel_surcharge` | Weekly fuel surcharge % for ODFL, Saia, Estes, ABF, R+L, TForce, XPO, SEFL, Averitt — DOE diesel price and up to 5 years of history |
| `ltl_list_carriers` | Carrier coverage metadata (SCAC codes, update schedule, extraction method) |
| `abc_search_licenses` | Search CA, TX, NY, FL license databases by trade name, owner, or address |
| `abc_lookup_license` | Point-in-time license status by state-issued license number |
| `abc_list_states` | State coverage, latency, and CAPTCHA requirements |
## Workflow Prompts
| Prompt | Description |
|--------|-------------|
| `freight_audit_workflow` | Multi-step LTL invoice audit against published carrier tariffs |
| `license_compliance_check` | Compliance verification before distributor orders, insurance binding, or merchant onboarding |
## Get API Access
Subscribe via RapidAPI to receive your `X-API-Key`. Freemium plans available (10 req/day free).
| Product | RapidAPI Listing |
|---------|-----------------|
| **LTL Fuel Surcharge** | [rapidapi.com/ladourv/api/ltl-fuel-surcharge-api](https://rapidapi.com/ladourv/api/ltl-fuel-surcharge-api) |
| **ABC License Compliance** | [rapidapi.com/ladourv/api/abc-license-compliance-api](https://rapidapi.com/ladourv/api/abc-license-compliance-api) |
## Install
```bash
pip install nexusfeed-mcp
# or with uv/uvx (no install needed):
uvx nexusfeed-mcp
```
## Configure
```bash
export MCP_API_BASE_URL=https://api.nexusfeed.dev
export MCP_API_KEY=sk_live_your_key_here
```
## Run (stdio)
```bash
# LTL tools only — 3 tools, 1 prompt
nexusfeed-ltl
# ABC tools only — 3 tools, 1 prompt
nexusfeed-abc
# All tools — 5 tools, 2 prompts
nexusfeed-mcp
```
## Claude Desktop Configuration
**LTL fuel surcharge only:**
```json
{
"mcpServers": {
"nexusfeed-ltl": {
"command": "uvx",
"args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
}
```
**ABC license compliance only:**
```json
{
"mcpServers": {
"nexusfeed-abc": {
"command": "uvx",
"args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
}
```
**All tools:**
```json
{
"mcpServers": {
"nexusfeed-mcp": {
"command": "uvx",
"args": ["nexusfeed-mcp"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
}
```
## Cline (VS Code) Configuration
Open Cline settings → MCP Servers → Add Server manually:
**LTL only:**
```json
{
"nexusfeed-ltl": {
"command": "uvx",
"args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
```
**ABC only:**
```json
{
"nexusfeed-abc": {
"command": "uvx",
"args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],
"env": {
"MCP_API_BASE_URL": "https://api.nexusfeed.dev",
"MCP_API_KEY": "sk_live_your_key_here"
}
}
}
```
## Streamable HTTP (Smithery / remote clients)
| Server | URL |
|--------|-----|
| LTL tools | `https://api.nexusfeed.dev/mcp-ltl/` |
| ABC tools | `https://api.nexusfeed.dev/mcp-abc/` |
Pass your `X-API-Key` header on every request. Server metadata (no auth):
```
https://api.nexusfeed.dev/.well-known/mcp/server-card-ltl.json
https://api.nexusfeed.dev/.well-known/mcp/server-card-abc.json
```
## Verifiability
Every tool response includes:
```json
"_verifiability": {
"source_timestamp": "2026-04-05T09:00:00Z",
"extraction_confidence": 0.97,
"raw_data_evidence_url": "https://odfl.com/...",
"extraction_method": "api_mirror",
"data_freshness_ttl_seconds": 604800
}
```
- `extraction_confidence >= 0.90` is required before using data in compliance-critical decisions
- `source_timestamp` within `data_freshness_ttl_seconds` means data is fresh from cache
- `raw_data_evidence_url` is the canonical source — agents can independently verify
## Example Usage
**Audit an LTL freight invoice:**
```
Use the freight_audit_workflow prompt with carrier="ODFL", invoice_date="2026-04-01",
invoiced_fuel_surcharge_pct="23.5" to check whether the billed rate matches the
published tariff.
```
**Verify a liquor license before a distributor transaction:**
```
Use abc_search_licenses with state="CA" and trade_name="Total Wine" to check
current license status, then abc_lookup_license for the full record with suspension history.
```
## Troubleshooting
| Symptom | Fix |
|---------|-----|
| 401 on every call | `MCP_API_KEY` is not set or is invalid |
| "Could not reach API server" | `MCP_API_BASE_URL` not set — should be `https://api.nexusfeed.dev` |
| TX endpoints return 503 | TX TABC requires 2Captcha configured server-side; use CA, NY, or FL instead |
| `extraction_confidence` < 0.90 | Data quality degraded — verify independently via `raw_data_evidence_url` |
## License
**Client code (this repository): MIT.** See [LICENSE](LICENSE).
**NexusFeed backend service (`https://api.nexusfeed.dev`): commercial.** The MIT license above covers only the Python client wrapper in this repo. It does not grant rights to the data service, which requires a paid API key and is governed by a separate Terms of Service. Contact [ops@nexusfeed.dev](mailto:ops@nexusfeed.dev) for enterprise SLA and licensing.
<!-- mcp-name: io.github.NexusFeed/nexusfeed-ltl -->
<!-- mcp-name: io.github.NexusFeed/nexusfeed-abc -->