FutureSense MCP Server

556 AI-agent tools for invoicing, payroll, booking, accounting, CRM, and tax filing. Works with Claude, ChatGPT, Gemini, Cursor, and any MCP-compatible client.

What is this?

One MCP server that gives AI agents full access to the FutureSense business platform — 10 app domains, 556 tools, one API key.

FutureSense is a multi-app business platform. This MCP server exposes every operation as a callable tool so AI agents can automate your business end-to-end: create invoices, process payroll, schedule appointments, file IRS Form 2290, manage CRM contacts, run accounting reports, and more.

Apps & Tools

| App | Tools | What agents can do | |-----|-------|-------------------| | Invoicer | 103 | Create invoices, manage products, track expenses, reconcile banks, file taxes, credit notes, deposits, receipts | | Booking System | 98 | Schedule appointments, manage services, AI no-show prediction, team management, group events, coupons, recurring bookings | | Accounting | 90 | Journal entries, budgets, fixed assets, property management, medical billing, balance sheet, P&L reports | | Payroll | 37 | Process payroll, manage employees, generate T4/ROE, time tracking | | IRS Form 2290 | 39 | File heavy vehicle use tax, manage vehicles, track form submissions | | PersonalCFO | 38 | Track personal finances, AI insights, cash flow projections, budgets | | CRM | 30 | Manage contacts, email campaigns, sequences, bulk operations | | Content/Blog | 34 | Generate blogs, social posts, SEO copy, competitive intelligence | | AI Caller | 17 | Make AI-powered phone calls, send SMS, manage call-based appointments | | Central | 70 | Credits, subscriptions, API keys, integrations, AI text/image generation, admin |

Quick Start

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "futuresense": {
      "command": "npx",
      "args": ["-y", "futuresense-mcp"],
      "env": {
        "FUTURESENSE_API_KEY": "fs_your_key_here"
      }
    }
  }
}

Claude Code (CLI)

Add to ~/.claude/.mcp.json:

{
  "mcpServers": {
    "futuresense": {
      "command": "npx",
      "args": ["-y", "futuresense-mcp"],
      "env": {
        "FUTURESENSE_API_KEY": "fs_your_key_here"
      }
    }
  }
}

Cursor / Windsurf / VS Code

Use the same JSON block in your IDE's MCP settings panel.

OpenAI Agents SDK

from agents import Agent
from agents.mcp import MCPServerStdio

mcp = MCPServerStdio(
    command="npx",
    args=["-y", "futuresense-mcp"],
    env={"FUTURESENSE_API_KEY": "fs_your_key_here"}
)
agent = Agent(name="Business Agent", tools=mcp.list_tools())

Gemini / Google ADK

Works with any MCP-compatible client using stdio transport. Configure the same command/args/env block in your ADK tool definition.

Run from source (development)

git clone https://github.com/futuresenseai/centralized-payment-system
cd mcp-server
npm install
npm run build
FUTURESENSE_API_KEY=fs_your_key_here node dist/index.js

Get Your API Key

1. Sign up at hub.futuresenseai.com
2. Go to Dashboard → Developer → API Keys
3. Create a key (it starts with fs_)
4. Set it as FUTURESENSE_API_KEY in your MCP config

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | FUTURESENSE_API_KEY | Yes | Your API key (starts with fs_) | | FUTURESENSE_APP_ID | No | Default app context (default: central) | | FUTURESENSE_API_URL | No | Custom API URL (default: production endpoint) | | FUTURESENSE_BEARER_TOKEN | No | Firebase ID token for bearer-only routes (AI, Stripe) | | FUTURESENSE_USER_ID | No | Firebase UID — enables direct Firestore reads for faster list operations | | GOOGLE_APPLICATION_CREDENTIALS | No | Path to service account JSON — alternative to FUTURESENSE_USER_ID for Admin SDK reads |

Authentication Model

The server uses a hybrid auth approach for reliability and speed:

| Category | Auth method | Used for | |----------|-------------|---------| | Read tools | Firebase Admin SDK + FUTURESENSE_USER_ID | List/get operations — direct Firestore, no token expiry | | Write tools | FUTURESENSE_API_KEY | Create/update/delete — REST API with server-side validation | | AI / Stripe tools | FUTURESENSE_BEARER_TOKEN | AI generation, subscription checkout, payment operations |

For most users, only FUTURESENSE_API_KEY is needed. The server falls back to REST for reads if Admin SDK is not configured.

Admin SDK Setup (optional, faster reads)

Option A — Service account (recommended for production):

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
export FUTURESENSE_USER_ID="your-firebase-uid"

Option B — gcloud ADC (recommended for development):

gcloud auth application-default login
export FUTURESENSE_USER_ID="your-firebase-uid"

Pricing

Pay-as-you-go with universal credits. No monthly minimums.

| Operation type | Credit cost | |---------------|-------------| | Read (list, get) | 1–2 credits | | Write (create, update, delete) | 2–5 credits | | AI operations (text, image, analysis) | 5–12 credits |

Check the exact cost for any operation with the get_operation_cost tool before running it. Auto-reload is available — set a low-balance threshold and credits refill automatically.

Example Prompts

Once connected, you can give your AI agent natural language instructions:

"Create an invoice for Acme Corp for $5,000 due in 30 days, then send it."

"Show me all unpaid invoices over $1,000 and generate payment nudge emails for each."

"Book a 60-minute consultation for tomorrow at 2pm with John Smith."

"Run the monthly payroll for all active employees and generate T4 summaries."

"File IRS Form 2290 for our fleet of 12 vehicles."

"Generate a blog post about AI automation trends, then create social media snippets for LinkedIn and Twitter."

Tool Reference

Invoicing Tools (103)

list_invoices, get_invoice, create_invoice, update_invoice, send_invoice, mark_invoice_paid, list_quotations, create_quotation, list_expenses, create_expense, list_vendors, create_vendor, list_bills, list_accounts, list_journal_entries, create_journal_entry, get_profit_loss, get_balance_sheet, get_plaid_accounts, get_plaid_transactions, and 83 more covering products, credit notes, deposits, receipts, reconciliation, tax, periods, reports, and customers.

Booking Tools (98)

list_appointments, create_appointment, get_availability, list_services, manage_team, booking_ai_prediction, list_coupons, create_group_event, list_recurring_bookings, booking_analytics, and 88 more covering calendar sync, client management, notifications, templates, and waitlists.

Accounting Tools (90)

create_journal_entry, list_journal_entries, get_balance_sheet, get_profit_loss, list_accounts, create_budget, list_fixed_assets, manage_property, medical_billing_claim, and 81 more covering chart of accounts, reconciliation, period close, and multi-entity accounting.

Payroll Tools (37)

list_employees, create_employee, run_payroll, list_pay_runs, generate_t4, generate_roe, list_time_entries, and 30 more covering deductions, benefits, tax filing, and reporting.

IRS 2290 Tools (39)

list_vehicles, add_vehicle, create_2290_filing, submit_filing, get_filing_status, download_schedule_1, and 34 more covering VIN management, amendments, and e-filing.

PersonalCFO Tools (38)

get_personal_dashboard, list_personal_transactions, get_cash_flow_projection, get_ai_financial_insights, list_personal_budgets, and 33 more.

CRM Tools (30)

list_contacts, get_contact, create_contact, update_contact, delete_contact, list_campaigns, create_campaign, send_bulk_email, list_email_templates, create_email_template, and 20 more covering sequences, stats, and SMS.

Content & Blog Tools (34)

list_blogs, create_blog, generate_blog, list_social_posts, generate_social_post, get_blog_analytics, generate_seo, generate_content_ideas, generate_hashtags, create_social_snippet, and 24 more.

AI Caller Tools (17)

initiate_ai_call, list_call_history, get_call_status, send_sms, manage_call_scripts, and 12 more.

Central / Admin Tools (70)

get_credit_balance, get_subscription_status, list_all_subscriptions, create_checkout, cancel_subscription, list_api_keys, get_api_key, revoke_api_key, search_audit_logs, get_health, generate_text, generate_image, search_image, run_ai_command, format_ai_prompt, get_dashboard, list_marketplace_apps, list_plans, get_app_pricing, get_operation_cost, and 50 more.

Testing the Server

Use the MCP Inspector to browse and call tools interactively:

npx @modelcontextprotocol/inspector node dist/index.js

Compatible Clients

| Client | Transport | Notes | |--------|-----------|-------| | Claude Desktop | stdio | Full tool support | | Claude Code (CLI) | stdio | Full tool support | | ChatGPT Desktop | stdio | Requires MCP plugin enabled | | Gemini CLI / ADK | stdio | Any MCP-compatible client | | Cursor | stdio | Configure in MCP settings | | Windsurf | stdio | Configure in MCP settings | | VS Code (Cline, Continue) | stdio | Extension-dependent | | Custom agents | stdio | OpenAI Agents SDK, LangChain, etc. |

Requirements

• Node.js >= 18
• A FutureSense API key (fs_...)
• Optional: Firebase credentials for Admin SDK reads

Links

• Website: hub.futuresenseai.com
• API Docs: hub.futuresenseai.com/developer
• npm: npmjs.com/package/futuresense-mcp
• Issues: github.com/futuresenseai/centralized-payment-system/issues

License

MIT — see LICENSE for details.