Luca Assistant (撸卡助手)
A credit card optimization tool layer for AI coding agents. Luca provides a database of US credit cards, sign-up bonuses, bank rules, and community data points — exposed as MCP tools that any agent can call.
Luca is a fuse layer, not a standalone agent. Your agent (Claude Code, OpenClaw, OpenCode, Codex) owns the LLM and conversation. Luca owns the data.
Install
As a Claude Code Plugin
# Add the marketplace
/plugin marketplace add troyt-666/luca-assistant
# Install
/plugin install luca-assistant@luca-marketplace
This gives you 11 MCP tools + 5 slash commands.
As an MCP Server
# From PyPI (when available)
claude mcp add --transport stdio luca-assistant -- uvx --from luca-assistant luca-mcp
# From source
git clone https://github.com/troyt-666/luca-assistant
cd luca-assistant
uv sync
claude mcp add --transport stdio luca-assistant -- uv run luca-mcp
Slash Commands (Plugin)
| Command | Description |
|---|---|
/luca-assistant:card-lookup |
Look up a card's details and offers |
/luca-assistant:compare-cards |
Side-by-side card comparison |
/luca-assistant:portfolio |
Your portfolio + 5/24 status |
/luca-assistant:bank-rules |
Bank application rules |
/luca-assistant:scrape |
Fetch fresh community data |
MCP Tools (11)
| Tool | Description |
|---|---|
luca_query_card_details |
Look up a card's benefits, offers, and fees |
luca_find_highest_offers |
Find the best current sign-up bonuses |
luca_compare_card_benefits |
Side-by-side card comparison |
luca_get_bank_rules |
Bank-specific application rules (5/24, lifetime language, etc.) |
luca_get_user_portfolio |
Your current card portfolio |
luca_check_chase_524_status |
Calculate 5/24 slots remaining |
luca_add_user_card |
Add a card to your portfolio |
luca_close_user_card |
Mark a card as closed |
luca_scrape_source |
Fetch fresh content from a source (doc, reddit, forum) |
luca_search_scraped |
Search previously scraped content |
luca_get_scrape_status |
Check when each source was last scraped |
What's in the Database
- 30+ popular US credit cards — Chase, Amex, Citi, Capital One, Bilt, US Bank, Wells Fargo
- Current sign-up bonuses with estimated USD values and spend requirements
- Category multipliers and credits (dining, travel, grocery, etc.)
- Bank application rules — Chase 5/24, Amex lifetime language, Citi 8/65, 2/90, one-Sapphire, and more
- Scraped content from Doctor of Credit, Reddit r/CreditCards, r/churning, and US Card Forum
CLI
luca cards # List all cards in DB
luca cards --bank Chase # Filter by bank
luca scrape # Scrape all sources
luca scrape --source doc # Scrape Doctor of Credit only
luca scrape --dry-run # Show what would be fetched
luca schedule enable --interval 6 # Set up cron job (every 6 hours)
luca schedule status # Check cron status
luca chat # Interactive chat (test harness, needs LLM key)
Development
git clone https://github.com/troyt-666/luca-assistant
cd luca-assistant
make dev # Install with dev deps
make test # Run 67 tests
make lint # Ruff lint check
make format # Ruff auto-format
License
MIT
Metadata
Release files for luca-assistant 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| luca_assistant-0.1.0.tar.gz | 35.2 kB | With provenance | Details for luca_assistant-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| luca_assistant-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for luca_assistant-0.1.0-py3-none-any.whl |
Total release size: 61.8 kB
Release files / luca_assistant-0.1.0.tar.gz
| Download URL | luca_assistant-0.1.0.tar.gz |
|---|---|
| Size | 35.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e627e9ecb9a6ea96546e5936854e71e990af7d55fbe4d497ce8d3d770234b1c6
|
|
BLAKE2b-256 checksum How to use checksums |
389d6a191736e2e5ef6ccaa8c4f6c3758347b971796cbb1bded6cfab6141aa99
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 22, 2026.
Transparency logRelease files / luca_assistant-0.1.0-py3-none-any.whl
| Download URL | luca_assistant-0.1.0-py3-none-any.whl |
|---|---|
| Size | 26.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0c0f0713e24229d870cb17aa04f31e0729346554e5ae9c421012bbf465dda7f8
|
|
BLAKE2b-256 checksum How to use checksums |
46dad72b4b7e95373eb286b2c183f18f28a83659f01d422d810d9c2e1d1a8261
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 22, 2026.
Transparency logSecurity for luca-assistant 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for luca_assistant-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 22, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.