{ "version": "2", "generatedAt": "2026-11-03T22:49:39.280Z", "listing": { "slug": "WellApp-ai--Well", "name": "Well", "tagline": "Supplier-invoice retrieval and ledger data behind one official MCP endpoint and CLI; MIT toolkit repo.", "shortTagline": "Supplier invoices and ledger over MCP", "description": "Well retrieves supplier invoices from 100,000+ web portals, email, and WhatsApp through a Chrome extension, structures them, and exposes invoices, companies, contacts, transactions, and the accounting ledger as MCP tools at api.wellapp.ai/v1/mcp, with a Claude Code plugin and a Python CLI over the same OAuth backend. The hosted product is in private beta and free to start; the MIT repo holds the CLI, exporters (JSON, CSV, UBL, QuickBooks IIF, Xero CSV), extractor tooling, and the plugin.", "capabilities": [ "adaptable", "operable" ], "vertical": "support-bookkeeping", "alternativeTo": [ "Dext", "Hubdoc" ], "shape": "agent-workflow", "formFactor": "mcp-server", "executionModel": "ai-inferential", "provenance": "unknown", "codeStack": { "languages": [ "Python", "TypeScript" ], "frameworks": [], "packageManager": "npm, pip", "database": [], "hostingTarget": [ "hosted at api.wellapp.ai", "Chrome Web Store extension", "local CLI (Python 3.8+, stdlib only)" ] }, "modelStack": { "providers": [ "any MCP client" ], "models": [], "requiredKeys": [], "promptLocations": [ "plugins/well (Claude Code skills)", ".claude-plugin/" ], "tools": [ "well_get_schema", "well_query_records", "well_get_entity", "well_add_contact_channel", "well_remove_contact_channel", "well_update_invoice", "well_delete_invoice" ] }, "repos": [ { "url": "https://github.com/WellApp-ai/Well", "owner": "WellApp-ai", "name": "Well", "license": "MIT", "stars": 339, "lastCommit": "2026-08-07" } ], "interface": { "kind": "mcp", "url": "https://api.wellapp.ai/v1/mcp", "official": true, "hosted": "remote" }, "operability": "official", "recommendedWrapper": null, "reach": [ { "job": "Query invoices, companies, people, transactions, and the ledger", "reachable": true, "evidence": "well_query_records with roots invoices, companies, people, documents, connectors; well_get_schema" }, { "job": "Fetch one record", "reachable": true, "evidence": "well_get_entity" }, { "job": "Update or delete an invoice", "reachable": true, "evidence": "well_update_invoice, well_delete_invoice" }, { "job": "Maintain contact channels on companies and people", "reachable": true, "evidence": "well_add_contact_channel, well_remove_contact_channel" }, { "job": "Build a P&L, balance sheet, or reconcile transactions", "reachable": true, "evidence": "README: Claude Code plugin bundles finance skills (compte de resultat, balance sheet, reconcile transactions) on top of the MCP" }, { "job": "Retrieve invoices from supplier portals", "reachable": false, "evidence": "retrieval runs in the Chrome extension with blueprints; no MCP tool triggers it" }, { "job": "Export to QuickBooks, Xero, UBL", "reachable": false, "evidence": "exporters are a Python library in the repo, not an MCP tool" }, { "job": "Connect Gmail, WhatsApp, Drive, Slack sources", "reachable": null, "evidence": "site: 120+ connectors behind one endpoint; connectors root is queryable, setup path not documented" }, { "job": "Teach a new portal blueprint", "reachable": false, "evidence": "Contributor Mode in the extension" } ], "editions": [ { "name": "Free (private beta)", "price": null, "open": false, "distributions": [ { "kind": "hosted", "url": "https://wellapp.ai/" }, { "kind": "installable", "url": "https://github.com/WellApp-ai/Well/tree/main/cli", "command": "curl -fsSL https://raw.githubusercontent.com/WellApp-ai/Well/main/cli/well -o /usr/local/bin/well" } ] }, { "name": "Toolkit repo", "price": null, "open": true, "distributions": [ { "kind": "source", "url": "https://github.com/WellApp-ai/Well" } ] } ], "skills": { "kind": "bundled", "paths": [ "cursor-rules/skills/*/SKILL.md", ".claude-plugin/marketplace.json" ], "install": "/plugin marketplace add WellApp-ai/Well", "note": "Ships a Claude Code plugin marketplace and a library of workflow skills alongside the MCP server." }, "customization": { "summary": "The hosted service is closed; what you adapt is the toolkit: the CLI reads WELL_URL and WELL_CLI_PORT, the Claude Code plugin under plugins/well carries the finance skills you can edit, and new export formats are a Python class registered with @ExporterFactory.register in exporters/. Expect to write a little code for anything beyond pointing the CLI or plugin at your account.", "envVars": [ "WELL_URL", "WELL_CLI_PORT" ], "configFiles": [ ".claude-plugin/", "~/.well/credentials.json (generated)" ], "promptFiles": [ "plugins/well/" ], "effort": "light-edit", "editCount": 5 }, "useWhen": [ "month-end means logging into fifteen supplier portals to download invoices and we want that done for us and queryable from our agent", "we want our agent to list unpaid supplier invoices and fix vendor details from the terminal, then hand a clean export to the accountant" ], "accounts": [ "Well account (private beta)", "Chrome for the retrieval extension" ], "active": true, "lastActivity": "2026-08-07", "gotchas": [ "Private beta; pricing after beta is unpublished", "Retrieval only works in Chrome; the MCP sees what the extension has already captured", "Repo is a toolkit around a closed hosted backend, not the product source", "French-market accents (compte de resultat, Factur-X) in the skills" ], "fit": { "adaptable": 1, "operable": 2 }, "evidence": { "formFactor": "README MCP Integration: hosted endpoint https://api.wellapp.ai/v1/mcp; cli/README.md: CLI talks to the Well MCP over JSON-RPC", "executionModel": "site: AI-generated workflow blueprints, self-healing automations; extractor packages in repo", "operability": "README tool table and docs/mcp/TOOLS.md; plugin marketplace WellApp-ai/Well", "effort": "cli/README.md configuration table names WELL_URL and WELL_CLI_PORT; README Extending Well shows the exporter class pattern", "editions": "wellapp.ai: Private beta. Start free. No credit card.", "active": "gh api: pushed 2026-08-07, 339 stars; Chrome Web Store badge" }, "confidence": { "formFactor": 0.85, "executionModel": 0.7, "operability": 0.9, "effort": 0.75, "reach": 0.8, "editions": 0.6 }, "openQuestions": [ "Post-beta pricing", "Whether connectors can be created through the MCP", "Provenance of the repo code" ], "sources": [ { "url": "https://github.com/WellApp-ai/Well", "foundBy": "sourcing:support-bookkeeping:github" }, { "url": "https://wellapp.ai/", "foundBy": "sourcing:support-bookkeeping:github" }, { "url": "https://github.com/WellApp-ai/Well/blob/main/docs/mcp/TOOLS.md", "foundBy": "analysis" } ], "research": { "stage": "verified", "verdict": "unverified", "reason": "Official MCP with writes on a real receipt-and-invoice capture product; adaptable only as a toolkit. Replaced the archived The-Commit-Company--mint on the shortlist.", "disputed": [] }, "url": "apps/WellApp-ai--Well.html", "coverage": "partial", "paid": false, "source": "research/verified/WellApp-ai--Well.json" } }