Lantern Works deals — MCP server (read-only, local stdio)

mcp-name: io.github.connormatthewdouglas/lantern-works-deals

Built on the official Python MCP SDK (mcp>=1.10,<2, FastMCP). Tools:

Errors: {"error": {"code": "invalid_argument|invalid_cursor|not_found|feed_unavailable|feed_invalid", "message": ...}}.

Data: https://thelanternworks.com/api/v1/deals.json, cached 5 min (stale copy served if a refetch fails). Overrides: LANTERN_DEALS_FILE (local JSON), LANTERN_DEALS_URL. Only an allow-list of public fields is returned. Ranking (core/deals.py) uses offer type, relevance, known price and verified_at freshness, never affiliate status or commission.

Install

git clone https://github.com/connormatthewdouglas/agent-work-stack-deals.git
cd agent-work-stack-deals
python3 -m venv .venv && .venv/bin/pip install -r mcp_server/requirements.txt

Claude Desktop (claude_desktop_config.json) / Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "lantern-works-deals": {
      "command": "/ABS/PATH/agent-work-stack-deals/.venv/bin/python",
      "args": ["/ABS/PATH/agent-work-stack-deals/mcp_server/server.py"]
    }
  }
}

Test

.venv/bin/pip install pytest && .venv/bin/python -m pytest -q tests
.venv/bin/python mcp_server/smoke/smoke_client.py   # real stdio client session, live feed

Package (built and tested locally, not yet on PyPI)

pyproject.toml at the repo root builds lantern-works-deals-mcp with a lantern-works-deals-mcp console command:

python3 -m build && pip install dist/lantern_works_deals_mcp-0.1.0-py3-none-any.whl
lantern-works-deals-mcp   # stdio server

Once published, the config becomes {"command": "uvx", "args": ["lantern-works-deals-mcp"]}.

Client validation

Transcripts in smoke/: official Python SDK client (transcript.txt), MCP Inspector CLI (inspector_cli_transcript.txt), OpenAI Agents SDK MCPServerStdio (agents_sdk_transcript.txt).

server.json passes mcp-publisher validate and has not been submitted.