Skip to main content

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)

Source distribution for luca-assistant 0.1.0
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)

Table of built distributions (wheels) for luca-assistant 0.1.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page