futuresense-mcp

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

Hosted connector (no install, no API key)

Add https://mcp-oefjwqkrvq-uc.a.run.app/mcp as a custom connector (claude.ai / Claude Desktop: Settings → Connectors → Add custom connector; Claude Code: claude mcp add --transport http futuresense https://mcp-oefjwqkrvq-uc.a.run.app/mcp). Sign in with your FutureSense account and choose which apps to allow. The hosted connector runs in discovery mode (fs_search_tools → fs_describe_tool → fs_call_tool).

Local (npm, API key)

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

• Sign up at hub.futuresenseai.com
• Go to Dashboard → Developer → API Keys
• Create a key (it starts with fs_)
• 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
FUTURESENSE_TOOL_MODE	No	toolsets (default), full (all tools, 1.x behavior) or discovery (3 meta-tools) — see Tool Modes
FUTURESENSE_TOOLSETS	No	Comma-separated toolset ids or all (e.g. booking,payroll)
FUTURESENSE_FIREBASE_PROJECT_ID	No	Firebase project for Admin SDK reads (default: paymentgateway-ab783)
FUTURESENSE_APP_URLS	No	JSON object overriding child-app API URLs, e.g. {"invoicer":"https://..."}

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)

firebase-admin is an optional peer dependency — it is not installed with the package. Install it alongside (npm install firebase-admin) only if you use Admin SDK reads; otherwise the server runs REST-only.

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"

Tool Modes (2.0)

600+ tool schemas overwhelm most MCP clients, so 2.0 loads a subset by default.

Mode	What the client sees
toolsets (default)	Tools from the selected toolsets. With no FUTURESENSE_TOOLSETS, loads core + the toolsets for FUTURESENSE_APP_ID (e.g. invoicer → invoicer + invoicing; central → crm, invoicing, accounting, ai, content)
full	All tools — same as 1.x
discovery	3 meta-tools: fs_search_tools → fs_describe_tool → fs_call_tool. Searches every toolset (except admin) without loading their schemas

Toolsets: core, ai, crm, content, invoicing, invoicer, accounting, property, medical, booking, payroll, irs2290, personalcfo, aicaller, firm, ecometric, sitespark, evcorridor, veda, admin (admin accounts only; never included by all — list it explicitly). Explicit FUTURESENSE_TOOLSETS replaces the defaults, so add core if you want it.

Upgrading from 1.x: set FUTURESENSE_TOOL_MODE=full to keep every tool, and pass confirm: true to high-impact tools (see Tool Safety).

Tool Safety

Every tool carries MCP annotations (readOnlyHint, destructiveHint, openWorldHint) so clients can tell reads from writes.

High-impact tools (payroll processing/approval/void, direct deposit, IRS 2290 submission, refunds, period close/lock, year-end close, bulk email/SMS/campaign sends, outbound AI calls, API key and connection revocation, subscription cancel) take an extra confirm parameter. Called without confirm: true they return a preview and make no API request; the agent should show the preview to the user and re-call with confirm: true after approval. Full list: GUARDED_TOOLS in src/annotations.ts.

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.

ecoMetric Tools (24)

ecometric_search_properties, ecometric_get_score, ecometric_compare_properties, ecometric_get_comparables, ecometric_create_report, ecometric_search_permits, ecometric_get_property_violations, ecometric_search_assessments, ecometric_ai_property_insight, and 15 more. Property ESG scores and public government records.

SiteSpark Tools (16)

sitespark_list_sites, sitespark_create_site, sitespark_update_site, sitespark_verify_domain, sitespark_create_product, sitespark_list_leads, sitespark_get_subscription_status, and 9 more. Website builder: sites, products, leads.

EV Corridor Tools (12)

evcorridor_plan_route, evcorridor_list_car_profiles, evcorridor_nearby_stations, evcorridor_get_distance, evcorridor_get_station_reliability, evcorridor_save_trip, and 6 more. Free EV road-trip planning.

Veda Tools (1)

veda_sidereal_sign — free Vedic Sun/Moon/rising signs + nakshatra from birth details. No API key needed.

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
• Hosted connector: https://mcp-oefjwqkrvq-uc.a.run.app/mcp
• MCP Registry: io.github.Sams3595/futuresense-mcp
• Smithery: smithery.ai/server/futuresenseAI/futuresenseAI
• Glama: glama.ai/mcp/servers/Sams3595/futuresense-mcp
• Issues: github.com/Sams3595/futuresense-mcp/issues

License

MIT — see LICENSE for details.