thred-mcp

The tool layer behind Ask Thred — an AI finance assistant for business owners. This MCP server connects AI assistants like Claude and ChatGPT to the Thred Partner API, giving them direct access to accounting, invoicing, and financial reporting.

Ask Thred is organized around three capability categories: Ask (read-only questions about your business), Do (commands that change state), and Watch (proactive, system-initiated alerts — a future roadmap phase). This package ships the atomic tools that power Ask and Do today.

What you can do

Ask — questions about your business (read-only, user-initiated)

Ask Claude or ChatGPT things like:

• "How is the business doing?" — a plain-language business overview
• "What does our cash flow look like this quarter?"
• "What's pending right now?" — open invoices, unpaid bills, items needing attention
• "Who owes us money?" — accounts receivable and collections
• "How much are we spending with each vendor?" — accounts payable and vendor spend
• "What happens to cash if revenue drops 20%?" — scenario analysis
• "Show me a dashboard of revenue vs. expenses for the last 6 months" — custom, natural-language dashboards
• "Prepare my board pack for Q1" — a composed financial summary for stakeholders

Do — commands that change state (write/execute, user-initiated)

• "Create an invoice for Acme for $500"
• "Send the invoice to Acme"
• "Send a payment reminder to customers who are overdue"
• "Reach out to Office Supplies Co about the open bill"
• "Export the P&L report for Q1 2026"

Do actions are governed by behavioral rules that the AI assistant applies on top of these tools:

• Confirmation before high-risk actions (sending money-related communications, voiding records).
• Slot-filling for missing required details (e.g. amount, due date) before executing.
• AI matching of spoken/typed customer and vendor names to the right Thred records.
• AI-composed emails for reminders and vendor outreach.
• Action chaining — suggesting the natural next step (e.g. after creating an invoice, offer to send it).

Watch — proactive alerts (future roadmap, not yet available)

Watch is the product direction for Ask Thred and is not implemented in this MCP server today. It describes system-initiated behavior, not capabilities you can call right now.

Planned Watch capabilities include:

• Overdue payment alerts
• Payment received notifications with auto-reconciliation
• Periodic business updates
• Cash-low warnings
• Unusual transaction flags

Voice (product direction)

Voice is a first-class input modality for the Ask Thred product (speech → transcription → the same intent pipeline that handles typed requests). The MCP server itself is text/tool based; voice is handled upstream in the product, not in this package.

Tools included

The server exposes a focused set of atomic tools. Composed capabilities — board packs, natural-language dashboards, payment reminders, vendor outreach — are not single dedicated endpoints; they are achieved by the AI assistant orchestrating these atomic tools and composing the content (narrative, emails, layouts) around the returned data.

| Category | Tools | Powers | |----------|-------|--------| | Businesses | list, create, get, update, archive | Ask (overview), Do (setup) | | Customers | list, create, get, update, archive, unarchive | Do (name matching, AR), Ask (collections) | | Invoices | list, create, get, update, void | Do (create/send), Ask (pending) | | Invoice Payments | list, create, get, update, delete | Ask (cash in), Do (record payment) | | Vendors | list, create, get, update, archive, unarchive | Do (vendor outreach), Ask (AP/spend) | | Bills | list, create, get, update, void | Ask (pending), Do (manage bills) | | Bill Payments | list, create, get, update, delete | Ask (cash out), Do (record payment) | | Chart of Accounts | list, create, get, update, archive, hierarchy | Ask (reporting structure) | | Financial Reports | P&L, balance sheet, cash flow, AR aging, AP aging, financial summary | Ask (overview, cash flow, AR/AP, board pack), Do (export) |

Setup

1. Get your Thred credentials

Log in to the Thred Partner Portal and copy your Partner UUID and API Key from the API Keys section.

2. Connect to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (create it if it doesn't exist):

{
  "mcpServers": {
    "thred": {
      "command": "npx",
      "args": ["-y", "thred-mcp"],
      "env": {
        "THRED_PARTNER_UUID": "your-partner-uuid-here",
        "THRED_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop (Cmd+Q, then reopen). A hammer icon will appear — click it to see available Thred tools.

3. Connect to Cursor / VS Code / other MCP clients

Same config pattern — add to your MCP client's settings file with the same command, args, and env.

4. Run manually (for testing)

THRED_PARTNER_UUID=your-uuid THRED_API_KEY=your-key npx thred-mcp

Environment

By default thred-mcp connects to the production Thred environment (api.thredfi.com). Actions you take (creating invoices, recording payments, etc.) affect real data, so the AI assistant confirms high-risk actions before executing them.

To test safely against the sandbox, set one extra env var alongside your credentials:

| Variable | Values | Effect | |----------|--------|--------| | THRED_ENV | production (default) · sandbox | Selects the API environment | | THRED_BASE_URL | full origin, e.g. https://sandbox.thredfi.com | Explicit override; takes precedence over THRED_ENV |

"env": {
  "THRED_PARTNER_UUID": "your-sandbox-uuid",
  "THRED_API_KEY": "your-sandbox-key",
  "THRED_ENV": "sandbox"
}

Use your sandbox Partner UUID / API Key with sandbox, and your production credentials with the default. Credentials are environment-specific — they are not interchangeable.

License

MIT