{"name":"admin-substitute","version":"2.2.0","protocol":"MCP","protocolVersion":"2024-11-05","transport":["streamable-http","sse"],"transportDetails":{"streamable-http":{"endpoint":"https://adminsubstitute.com/api/v1/mcp","method":"POST"},"sse":{"endpoint":"https://adminsubstitute.com/api/v1/mcp/sse","method":"GET","description":"SSE stream returns endpoint event with POST URL. Compatible with Claude Desktop, Cursor, and older MCP clients."}},"description":"Admin Substitute MCP Server — AI-native business management for Australian trades & services. 77 tools covering the full business lifecycle: leads, quotes, jobs, invoicing, reviews, service catalog, analytics, reminders, communications, billing, agent ecosystem, integrations, business formation, hiring, funding, scaling, and lifecycle assessment. Agents can fully operate a trade business end-to-end.","authentication":{"type":"bearer","header":"Authorization","format":"Bearer ask_...","description":"Obtain an API key via POST /api/v1/onboard or the developer portal. Discovery methods (server/discover, tools/list, resources/list, ping) do not require auth."},"endpoints":{"mcp":"https://adminsubstitute.com/api/v1/mcp","mcp_sse":"https://adminsubstitute.com/api/v1/mcp/sse","docs":"https://adminsubstitute.com/api/v1/docs","openapi":"https://adminsubstitute.com/api/v1/openapi.json","agent_card":"https://adminsubstitute.com/.well-known/agent-card.json","server_json":"https://adminsubstitute.com/.well-known/mcp-server.json"},"tools":[{"name":"leads.list","description":"List leads and prospects. Returns name, phone, email, service type, status, priority, source, and timestamps. Supports filtering and cursor-based pagination. Tip: Use leads.create to add new leads, then leads.list to verify.","annotations":{"title":"List Leads","readOnlyHint":true,"openWorldHint":false}},{"name":"leads.create","description":"Create a new lead/prospect. Auto-assigns to the authenticated company. Source defaults to \"mcp\" if not specified.","annotations":{"title":"Create Lead","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"leads.update","description":"Update an existing lead. Pass the lead ID and any fields to change. Only provided fields are updated.","annotations":{"title":"Update Lead","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"quotes.list","description":"List quotes with line items, totals, status, and linked lead info. Supports filtering by status and cursor-based pagination. Tip: Create quotes with quotes.create (requires a lead_id from leads.create or leads.list first).","annotations":{"title":"List Quotes","readOnlyHint":true,"openWorldHint":false}},{"name":"quotes.create","description":"Create a quote for a lead. Provide line items with description, quantity, unitPrice, and total. Created in Draft status. Requires: lead_id from leads.list or leads.create. Next step: quotes.send to deliver to client.","annotations":{"title":"Create Quote","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"quotes.update","description":"Update a quote's status, line items, or total. Use to progress quotes through the pipeline.","annotations":{"title":"Update Quote","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"quotes.send","description":"Generate a shareable link for a quote and optionally send it to the client via SMS and/or email. Marks the quote as Sent. Returns the public URL clients can view and accept.","annotations":{"title":"Send Quote to Client","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"quotes.ai_price_suggestion","description":"AI-powered pricing intelligence. Analyses the 930+ item supplier catalog, company price book, and historical quotes to suggest optimal pricing with detailed reasoning. Returns line items, adjustments (urgency/complexity/location), market context, and confidence scores. ACCC-compliant: suggestions only, human decides final price. Requires Growth+ plan.","annotations":{"title":"AI Price Suggestion","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"jobs.list","description":"List jobs with status, scheduled dates, technician assignment, and invoice info. Includes linked lead and quote data. Supports cursor-based pagination.","annotations":{"title":"List Jobs","readOnlyHint":true,"openWorldHint":false}},{"name":"jobs.create","description":"Schedule a job for a lead. Optionally link to a quote and assign a technician. Status is auto-set to \"Scheduled\" if a date is provided, otherwise \"Quoted\". Requires: lead_id from leads.list. Next steps: jobs.update → jobs.complete → invoicing.generate.","annotations":{"title":"Create Job","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"jobs.update","description":"Update job status, schedule, notes, or technician. Progress jobs through the pipeline: Scheduled → In Progress → Completed.","annotations":{"title":"Update Job","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"jobs.complete","description":"Mark a job as completed. Optionally record satisfaction rating and trigger an automatic review request. This is the recommended end-of-job action. Requires: job_id from jobs.list. Next steps: invoicing.generate → payments.send_link → reviews.request.","annotations":{"title":"Complete Job","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"jobs.send_eta","description":"Send an \"on my way\" notification to the client via SMS and/or email with an optional ETA. Improves customer experience and reduces no-shows.","annotations":{"title":"Send On My Way","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"invoicing.generate","description":"Generate an invoice for a completed job. If Stripe Connect is active, automatically creates a payment link. Returns invoice number, total, and payment URL. Requires: job_id from jobs.list (job must be status=Completed). Next step: payments.send_link if needed.","annotations":{"title":"Generate Invoice","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"reviews.request","description":"Send a review request to a client after a completed job. Sends via email and optionally SMS with links to configured review platforms (Google, Hipages, etc). Requires: job_id from a completed job. Tip: reviews.platforms lists configured review URLs.","annotations":{"title":"Send Review Request","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"reviews.platforms","description":"List configured review platforms (Google, Hipages, Facebook, etc) with their URLs. Useful for knowing where to direct review requests.","annotations":{"title":"List Review Platforms","readOnlyHint":true,"openWorldHint":false}},{"name":"subcontractors.list","description":"List registered subcontractors in the vetted network. Filter by trade, status, or availability. Returns license, insurance, service areas, ratings, and job history.","annotations":{"title":"List Subcontractors","readOnlyHint":true,"openWorldHint":false}},{"name":"subcontractors.register","description":"Register a new subcontractor in the vetted network. Captures business details, trade license, insurance, service areas, and rates. Starts in \"pending\" status until verified. Requires Growth+ plan.","annotations":{"title":"Register Subcontractor","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"subcontractors.dispatch","description":"Dispatch a job to a subcontractor. Sends SMS notification and creates a dispatch record for tracking. Subcontractor must be in \"active\" or \"verified\" status. Returns dispatch details.","annotations":{"title":"Dispatch to Subcontractor","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"subcontractors.verify","description":"Update a subcontractor's verification status. Use to verify (check license/insurance), activate, suspend, or deactivate. Records verification timestamp.","annotations":{"title":"Verify Subcontractor","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"compliance.generate_swms","description":"Generate a site-specific SWMS (Safe Work Method Statement) compliant with WHS Regulations 2017 s.299-303 and Safe Work Australia standards. AI drafts the document with hazards, controls, PPE (with AS/NZS standards), and emergency procedures. CRITICAL: Output is an AI DRAFT only — must be reviewed and signed by a competent person before use. Requires Growth+ plan.","annotations":{"title":"Generate SWMS","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"services.list","description":"List all services in the company catalog with prices, descriptions, and categories. Useful for accurate quoting and understanding what the business offers.","annotations":{"title":"List Services","readOnlyHint":true,"openWorldHint":false}},{"name":"services.create","description":"Add a new service to the company catalog. Include name, description, price range, and category.","annotations":{"title":"Add Service","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"services.update","description":"Update an existing service in the catalog. Change price, description, or toggle active/inactive status.","annotations":{"title":"Update Service","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analytics.financials","description":"Financial summary: revenue, quote volume, conversion rate, lead count, and paid invoices for a time period.","annotations":{"title":"Financial Summary","readOnlyHint":true,"openWorldHint":false}},{"name":"analytics.detailed","description":"Detailed business analytics: conversion funnel, revenue trends, lead sources, response times, outstanding invoices, and communication stats. Requires Growth plan or above.","annotations":{"title":"Business Analytics","readOnlyHint":true,"openWorldHint":false}},{"name":"analytics.dashboard","description":"Quick business overview: total leads, quotes, jobs, revenue, leads this week, and chart data. Lighter and faster than full analytics.","annotations":{"title":"Dashboard Overview","readOnlyHint":true,"openWorldHint":false}},{"name":"reminders.create","description":"Schedule a follow-up reminder. Can be linked to a lead or job. Reminders appear in the dashboard and can trigger notifications.","annotations":{"title":"Create Reminder","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"reminders.list","description":"List upcoming scheduled reminders, sorted by date. Includes linked lead/job info for context.","annotations":{"title":"List Reminders","readOnlyHint":true,"openWorldHint":false}},{"name":"comms.list","description":"View sent SMS and email message history. Filter by channel, message type, or delivery status. Useful for auditing communications.","annotations":{"title":"Message History","readOnlyHint":true,"openWorldHint":false}},{"name":"clients.list","description":"List clients — leads who have at least one job. Includes job count, quote count, and total revenue per client. Useful for identifying repeat customers.","annotations":{"title":"List Clients","readOnlyHint":true,"openWorldHint":false}},{"name":"billing.usage","description":"Check current API and resource usage vs plan limits: API calls, SMS credits, email credits, LLM calls remaining.","annotations":{"title":"Check Usage","readOnlyHint":true,"openWorldHint":false}},{"name":"billing.status","description":"Check subscription status, plan details, billing cycle, and feature access. Useful for understanding what the business can and cannot do on their current plan.","annotations":{"title":"Billing Status","readOnlyHint":true,"openWorldHint":false}},{"name":"billing.list_plans","description":"List all available plans with pricing, features, limits, and feature flags. Public information — useful for discovering what plans exist before purchasing or upgrading.","annotations":{"title":"List Plans","readOnlyHint":true,"openWorldHint":false}},{"name":"billing.create_checkout","description":"Create a Stripe Checkout session for upgrading or purchasing a plan. Returns a URL to present to the human operator for payment. The human completes payment in their browser.","annotations":{"title":"Create Checkout","readOnlyHint":false,"openWorldHint":true}},{"name":"billing.get_portal","description":"Get a Stripe Billing Portal URL for the human to manage their subscription — update payment methods, view invoices, change plans, or cancel. Requires an existing Stripe subscription.","annotations":{"title":"Billing Portal","readOnlyHint":true,"openWorldHint":true}},{"name":"wallet.balance","description":"Get the current wallet balance, lifetime stats, and recent transactions. Every MCP tool call costs credits (reads ~$0.01, writes ~$0.05). Free tools: discovery, formation, billing, wallet operations.","annotations":{"title":"Wallet Balance","readOnlyHint":true,"openWorldHint":false}},{"name":"wallet.deposit","description":"Create a Stripe PaymentIntent to top up your wallet with credits. Returns a client_secret for completing payment via Stripe SDK. Min $5, max $10,000. Wallet is credited automatically on successful payment.","annotations":{"title":"Deposit Credits","readOnlyHint":false,"openWorldHint":true}},{"name":"wallet.history","description":"Get detailed transaction history — deposits, deductions, transfers, refunds. Useful for cost analysis and budgeting.","annotations":{"title":"Transaction History","readOnlyHint":true,"openWorldHint":false}},{"name":"wallet.transfer","description":"Transfer credits from your wallet to another company. Used for agent-to-agent settlement — e.g., paying a subcontractor agent for completed work. Max $5,000 per transfer.","annotations":{"title":"Transfer Credits","readOnlyHint":false,"openWorldHint":false}},{"name":"wallet.crypto_deposit","description":"Create a cryptocurrency payment to top up your wallet. Accepts USDC and USDT stablecoins. Returns a payment address and amount. Wallet is credited on blockchain confirmation via webhook.","annotations":{"title":"Crypto Deposit","readOnlyHint":false,"openWorldHint":true}},{"name":"ecosystem.referral_link","description":"Get the company referral link and code. Share with other tradies — when they sign up via this link, the referring company earns commission. Agents can refer other agents and businesses.","annotations":{"title":"Get Referral Link","readOnlyHint":true,"openWorldHint":false}},{"name":"comms.send_sms","description":"Send an SMS message to a phone number on behalf of the company. Requires a valid Australian mobile number. Subject to monthly SMS quota.","annotations":{"title":"Send SMS","readOnlyHint":false,"openWorldHint":true}},{"name":"comms.send_email","description":"Send an email on behalf of the company. Subject to monthly email quota. HTML body supported.","annotations":{"title":"Send Email","readOnlyHint":false,"openWorldHint":true}},{"name":"webhooks.subscribe","description":"Register a webhook URL to receive real-time event notifications. Events are POST-ed as JSON with HMAC-SHA256 signature in X-Webhook-Signature header. Available events: lead_created, lead_updated, quote_created, quote_accepted, job_created, job_completed, invoice_sent, payment_received.","annotations":{"title":"Subscribe to Events","readOnlyHint":false,"openWorldHint":true}},{"name":"webhooks.unsubscribe","description":"Remove a webhook subscription by ID. Stops all future event deliveries to that URL.","annotations":{"title":"Unsubscribe from Events","readOnlyHint":false,"openWorldHint":false}},{"name":"webhooks.list","description":"List all active webhook subscriptions for this company.","annotations":{"title":"List Webhook Subscriptions","readOnlyHint":true,"openWorldHint":false}},{"name":"pricebook.search","description":"Search the Australian supplier catalog — 930+ products from 24+ wholesalers (Reece, Bunnings, Middy's, Dulux, etc). Filter by trade, subcategory, or free-text search. Returns RRP and typical trade cost.","annotations":{"title":"Search Supplier Catalog","readOnlyHint":true,"openWorldHint":false}},{"name":"pricebook.import","description":"Import products from the global supplier catalog into the company's own price book. Creates a company-level supplier and service catalog items. Applies default markup if specified.","annotations":{"title":"Import Supplier Products","readOnlyHint":false,"openWorldHint":false}},{"name":"marketing.strategy","description":"AI-powered lead generation strategy engine. Analyses your trade, region, demand intelligence, and historical lead data to recommend marketing channels with estimated costs and ROI. Includes content ideas, quick wins, and seasonal tips. Requires Pro plan.","annotations":{"title":"Generate Marketing Strategy","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"marketing.generate_content","description":"Generate marketing content for a specific channel. Supports Google Ads, Facebook posts, SMS campaigns, email templates, Google Business posts, and website copy. Generates headline, body, CTA, and SMS-length version. Includes A/B test variations. Requires Pro plan.","annotations":{"title":"Generate Marketing Content","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"payments.send_link","description":"Generate a payment link for a job and optionally send it to the client via SMS and/or email. Requires Stripe Connect to be active on the company. Requires: job_id. Tip: Use after invoicing.generate for the smoothest flow.","annotations":{"title":"Send Payment Link","readOnlyHint":false,"openWorldHint":true}},{"name":"integrations.list_connections","description":"List all active integration connections for the company. Shows provider name, status, last sync time, and supported entity types. Use this to discover what external systems are connected before pushing/pulling data.","annotations":{"title":"List Integration Connections","readOnlyHint":true,"openWorldHint":false}},{"name":"integrations.connection_status","description":"Get detailed status for a specific integration connection, including last sync results, error logs, and supported operations. Useful for diagnosing sync failures.","annotations":{"title":"Integration Connection Status","readOnlyHint":true,"openWorldHint":false}},{"name":"integrations.available_providers","description":"List all available integration providers (not just connected ones). Shows name, category, auth type, features, and whether an adapter is implemented. Use this to help users discover what they can connect.","annotations":{"title":"Available Integration Providers","readOnlyHint":true,"openWorldHint":false}},{"name":"integrations.sync","description":"Trigger a sync operation for a specific integration connection. Pulls or pushes entities depending on the provider configuration. Requires an active connection.","annotations":{"title":"Sync Integration","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"integrations.push_entity","description":"Push a specific entity (lead, job, invoice) to a connected integration. For example, push a completed job to Slack as a notification, or push an invoice to Xero. Requires an active connection with push capability for the entity type.","annotations":{"title":"Push Entity to Integration","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"workflows.trigger_invoice","description":"Generate and send an invoice for a completed job. Auto-pushes to connected accounting software (Xero/QuickBooks/MYOB/FreshBooks), generates Stripe payment link, and notifies the customer via SMS. Full pipeline: invoice → accounting sync → payment link → customer notification → team alert.","annotations":{"title":"Auto-Invoice Job","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.process_lead","description":"Full pipeline processing for a new lead: AI analysis → auto-quote from service catalog → job creation → Google Calendar sync → customer SMS → team Slack/Discord notification. The 'one-tap' lead processing pipeline.","annotations":{"title":"Process Lead Pipeline","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.quote_to_invoice","description":"Convert an accepted quote into a full invoice pipeline: create/update job → sync invoice to accounting (Xero/QB/MYOB) → generate Stripe payment link → notify customer → alert team. Handles the entire quote-accepted → paid lifecycle.","annotations":{"title":"Quote to Invoice Pipeline","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.sync_contact","description":"Force-sync a lead/contact to all connected integrations (CRM, accounting, marketing, Google Sheets). Useful for retrying failed syncs or manually triggering sync for existing leads.","annotations":{"title":"Force Sync Contact","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"workflows.pending_actions","description":"List pending workflow actions awaiting approval (draft quotes, invoices, review requests, SMS). These are auto-generated by the workflow engine and need manual review.","annotations":{"title":"List Pending Actions","readOnlyHint":true,"idempotentHint":true}},{"name":"workflows.approve_action","description":"Approve a pending draft action (quote, invoice, review request, SMS). The action will be executed immediately after approval.","annotations":{"title":"Approve Draft Action","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},{"name":"workflows.reject_action","description":"Reject/ignore a pending draft action. The action will not be executed.","annotations":{"title":"Reject Draft Action","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},{"name":"workflows.list","description":"List all workflow templates (automations) for the company with their trigger events, action types, and enabled status.","annotations":{"title":"List Workflows","readOnlyHint":true,"idempotentHint":true}},{"name":"workflows.toggle","description":"Enable or disable a workflow template.","annotations":{"title":"Toggle Workflow","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},{"name":"documents.auto_file","description":"File a document to connected cloud storage (Google Drive/Dropbox) in an organised company folder structure. Auto-generates folder paths based on entity type.","annotations":{"title":"Auto-File Document","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.instant_response","description":"Send an instant SMS + optional WhatsApp follow-up to a new lead within 30 seconds. Fires branded SMS templates for Growth+ plans.","annotations":{"title":"Instant Lead Response","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.schedule_job","description":"Smart-schedule a job for a lead — auto-picks next business day, syncs to Google Calendar, generates a Calendly booking link, and sends SMS confirmation.","annotations":{"title":"Smart Schedule Job","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.team_notify","description":"Send a rich, contextual notification to all connected team channels (Slack/Discord/Teams). Auto-enriches with AI summaries and action links based on event type.","annotations":{"title":"Team Notification","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.google_ads_pipeline","description":"Process a Google Ads lead through the full zero-touch pipeline: AI summary → auto-quote → auto-schedule → SMS → team notify. Tags lead as High priority with ad campaign attribution.","annotations":{"title":"Google Ads Pipeline","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.daily_summary","description":"Generate an AI-powered end-of-day business summary with today's leads, quotes, jobs, revenue, and tomorrow's schedule. Sends via SMS + team channels. Requires Starter+ plan.","annotations":{"title":"Daily Summary","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.review_booster","description":"Send an automated review request SMS to a customer after job completion. Includes Google Review link and AI-suggested review text. Requires Growth+ plan with SMS automations.","annotations":{"title":"Review Booster","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"workflows.chase_payment","description":"Auto-chase overdue invoices with escalating SMS + email reminders (friendly → firm → final). Includes Stripe payment links. Pass jobId to chase specific invoice, or omit to scan all overdue. Requires Growth+ plan.","annotations":{"title":"Payment Chaser","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.follow_up_quote","description":"Follow up on unsigned/pending quotes with escalating nudge messages (up to 3 follow-ups). Pass quoteId for specific quote, or omit to scan all pending quotes past follow-up threshold. Requires Growth+ plan.","annotations":{"title":"Quote Follow-Up","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.upsell_suggest","description":"AI-powered upsell/cross-sell engine. Analyzes customer job history against service catalog to suggest additional services. Can auto-generate draft quotes. Requires Pro plan.","annotations":{"title":"Upsell Engine","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"workflows.referral_program","description":"Manage referral program: generate referral codes for customers, send referral invites via SMS, track referral usage, and check rewards/stats. Requires Growth+ plan.","annotations":{"title":"Referral Program","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"operator.switch_company","description":"Switch the active company context for this operator. All subsequent tool calls will execute in the new company context.","annotations":{"title":"Switch Company","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"operator.get_portfolio","description":"List all companies in the operator's portfolio with basic metrics (lead/quote/job counts).","annotations":{"title":"Get Portfolio","readOnlyHint":true,"openWorldHint":false}},{"name":"operator.get_shared_suppliers","description":"List all shared supplier discounts negotiated by this operator, including which companies are linked.","annotations":{"title":"Get Shared Suppliers","readOnlyHint":true,"openWorldHint":false}},{"name":"operator.dashboard","description":"Get unified dashboard metrics across all operator companies: YTD/MTD revenue, profit, win rates, pipeline, and revenue waterfall.","annotations":{"title":"Operator Dashboard","readOnlyHint":true,"openWorldHint":false}},{"name":"formation.guided_setup","description":"RECOMMENDED ENTRY POINT — Intelligent business formation engine. Provide context about the person (trade, state, qualifications, budget, goals) and get a personalised formation plan with: (1) auto-detected pathway (licensed contractor, fresh start, or investor/operator), (2) task list split into AI-actionable vs human-required, (3) direct government portal links, (4) trade-specific insights (common first jobs, suppliers, rates, growth tips), (5) recommended next tool calls, (6) follow-up questions to ask. Call this FIRST, then use the recommended tool chain for deeper dives.","annotations":{"title":"Guided Business Setup","readOnlyHint":true,"openWorldHint":false}},{"name":"formation.requirements","description":"Get trade licensing and compliance requirements for a specific Australian state. Returns licence type, licensing body, requirements, cost estimates, renewal period, PLUS trade-specific insights (common first jobs, typical rates, key suppliers, trade associations, growth tips) and direct government portal links for the state.","annotations":{"title":"Formation Requirements","readOnlyHint":true,"openWorldHint":false}},{"name":"formation.checklist","description":"Get a complete step-by-step business formation checklist for a specific trade and state. Includes ABN registration, GST, licensing, insurance, WHS, banking, operations setup, and client acquisition — with time estimates and costs.","annotations":{"title":"Formation Checklist","readOnlyHint":true,"openWorldHint":false}},{"name":"formation.funding","description":"Get available Australian government grants, incentives, and funding programs for starting or growing a trade business. Filter by category: apprenticeship, small-business, export, digital, training.","annotations":{"title":"Formation Funding","readOnlyHint":true,"openWorldHint":false}},{"name":"formation.demand_hotspots","description":"Get trade demand hotspots across Australian regions. Returns demand scores, shortage severity, hourly rates, competition levels, growth trends, and opportunity notes. Use to advise where to start a trade business for maximum impact.","annotations":{"title":"Formation Demand Hotspots","readOnlyHint":true,"openWorldHint":false}},{"name":"formation.location_score","description":"Calculate an opportunity score (0-100) for a specific trade + region combination. Factors in shortage severity, growth trend, hourly rates, competition level, and construction growth. Returns score breakdown and recommendation.","annotations":{"title":"Formation Location Score","readOnlyHint":true,"openWorldHint":false}},{"name":"cashflow.forecast","description":"30-day cash flow forecast with weekly breakdown. Shows: revenue received (last 30 days), outstanding invoices, overdue invoices (with $ amount at risk), quote pipeline value, upcoming scheduled job revenue, projected inflow/profit, average days to payment, and 4-week forward forecast. Returns value context showing exactly how much time this saved vs doing it manually in a spreadsheet. Essential for answering \"Can I afford to hire?\" or \"How's my cash flow?\"","annotations":{"title":"Cash Flow Forecast","readOnlyHint":true,"openWorldHint":false}},{"name":"invoicing.chase","description":"Find and chase overdue invoices. GET mode (no jobId): returns all overdue invoices with days overdue, chase level (friendly/firm/final), and total $ outstanding. SEND mode (with jobId + tone): sends a payment reminder via email (+ optional SMS) with 3-tier escalation — friendly (7+ days), firm (14+ days), final (30+ days). Includes Stripe payment link if connected. Each chase sent is logged and tracked for recovery metrics. The single most revenue-generating tool — 60-70% of friendly reminders result in payment within 48 hours.","annotations":{"title":"Invoice Chaser","readOnlyHint":false,"openWorldHint":false}},{"name":"invoicing.recovery","description":"Track how much money has been recovered through auto-chase reminders. Returns total $ recovered and count of invoices that were overdue, got chased, and then got paid. This is the \"proof the platform pays for itself\" metric — show users exactly how much money Admin Substitute put back in their pocket.","annotations":{"title":"Invoice Recovery Tracker","readOnlyHint":true,"openWorldHint":false}},{"name":"jobs.profit_summary","description":"Per-job profit analysis for completed jobs. Returns: total revenue, total cost, total profit, average margin %, and breakdown by service type (sorted by profit). Each service type shows revenue, cost, profit, margin %, and job count. Identifies your most and least profitable service types so you can double down on winners and fix or drop losers. The insight that separates surviving tradies from thriving ones.","annotations":{"title":"Job Profit Tracker","readOnlyHint":true,"openWorldHint":false}},{"name":"formation.recommend_trade","description":"AI Trade Recommendation Engine — \"I have $X and want to start a trade business\" → ranked recommendations. Takes budget, state, goals, physical capability, risk tolerance and preferences, then scores ALL 9 trade categories across 4 factors (budget fit, time to revenue, revenue upside, barrier to entry) and returns top 5 ranked recommendations with: startup costs, licence requirements, projected Year 1 revenue (3 scenarios), break-even timeline, quick-win first actions, risks, and scalability rating. Perfect for \"what trade should I start?\" questions.","annotations":{"title":"Trade Recommendation Engine","readOnlyHint":true,"openWorldHint":false}},{"name":"formation.simulate_business","description":"12-Month Business Simulator — financial projection engine for Australian trade businesses. Input a trade, state, startup capital, working hours, and scenario (conservative/realistic/optimistic) to get month-by-month projections including: gross revenue, all expense categories, GST collected/owing, income tax estimates, superannuation, net profit, cash balance, and milestone detection (break-even month, capacity ceiling, hire trigger). Uses real Australian 2025-26 tax brackets, 10% GST, 12% super rate, and trade-specific cost profiles. Returns year-end summary with effective hourly rate, total take-home, and ROI on startup capital.","annotations":{"title":"12-Month Business Simulator","readOnlyHint":true,"openWorldHint":false}},{"name":"lifecycle.assess","description":"Assess which business lifecycle stage a trade business is in (formation → survival → capacity → funding → scaling) and get readiness score for the next stage. Returns current stage, signals met/unmet, transition triggers, recommendations, and blockers.","annotations":{"title":"Lifecycle Stage Assessment","readOnlyHint":true,"openWorldHint":false}},{"name":"hiring.capacity_analysis","description":"Analyse a solo tradesperson's capacity utilisation and determine if they've hit the ceiling. Returns capacity score (0-100), burnout risk, estimated lost revenue from declined work, and hiring urgency level.","annotations":{"title":"Capacity Analysis","readOnlyHint":true,"openWorldHint":false}},{"name":"hiring.readiness_score","description":"Calculate hiring readiness score across financial, operational, and systems dimensions. Recommends apprentice vs employee vs contractor vs admin-first hire based on business metrics.","annotations":{"title":"Hiring Readiness Score","readOnlyHint":true,"openWorldHint":false}},{"name":"hiring.cost_calculator","description":"Calculate the true cost of hiring an employee or apprentice in a specific Australian state. Includes base salary, super (12%), workers comp, payroll tax, leave provisions, tools, vehicle, and government incentives.","annotations":{"title":"Employment Cost Calculator","readOnlyHint":true,"openWorldHint":false}},{"name":"hiring.apprentice_workflow","description":"Get the complete 6-step apprenticeship workflow for Australian trade businesses. Covers: finding an Apprentice Connect provider, recruitment, training contract, STP/payroll setup, government incentive claims, and onboarding.","annotations":{"title":"Apprentice Workflow","readOnlyHint":true,"openWorldHint":false}},{"name":"hiring.compliance_checklist","description":"Get the Fair Work compliance checklist for hiring employees in Australia. Covers NES, Modern Awards, STP, superannuation, WHS, workers comp, contractor vs employee classification, and record keeping.","annotations":{"title":"Fair Work Compliance","readOnlyHint":true,"openWorldHint":false}},{"name":"funding.eligibility_scan","description":"Scan 20+ government funding programs and return which ones a specific trade business is eligible for. Includes federal grants, state programs, apprenticeship incentives, tax offsets, and digital adoption support. Returns estimated total funding available.","annotations":{"title":"Funding Eligibility Scan","readOnlyHint":true,"openWorldHint":false}},{"name":"funding.program_details","description":"Get detailed information about a specific government funding program including full eligibility criteria, application process, tips, and relevant links.","annotations":{"title":"Funding Program Details","readOnlyHint":true,"openWorldHint":false}},{"name":"scaling.readiness_score","description":"Assess if a trade business is ready to scale from solo/small operation to multi-crew operator mode. Evaluates financial strength, systems maturity, team capability, and market demand.","annotations":{"title":"Scaling Readiness Score","readOnlyHint":true,"openWorldHint":false}}],"resources":[{"uri":"admin-substitute://leads","name":"Leads","description":"All prospects and leads with contact info, status, and priority","mimeType":"application/json"},{"uri":"admin-substitute://quotes","name":"Quotes","description":"All quotes with line items, totals, and linked lead info","mimeType":"application/json"},{"uri":"admin-substitute://jobs","name":"Jobs","description":"All jobs with schedules, technician assignments, and completion status","mimeType":"application/json"},{"uri":"admin-substitute://clients","name":"Clients","description":"Clients with job counts, quote counts, and revenue totals","mimeType":"application/json"},{"uri":"admin-substitute://financials","name":"Financials","description":"Financial summary: revenue, conversion rates, invoice status","mimeType":"application/json"},{"uri":"admin-substitute://services","name":"Services","description":"Service catalog with pricing, categories, and descriptions","mimeType":"application/json"},{"uri":"admin-substitute://reminders","name":"Reminders","description":"Scheduled reminders and follow-ups with linked entity info","mimeType":"application/json"},{"uri":"admin-substitute://communications","name":"Communications","description":"SMS and email message history with delivery status","mimeType":"application/json"},{"uri":"admin-substitute://billing","name":"Billing","description":"Subscription status, plan details, and feature access","mimeType":"application/json"}],"tool_categories":{"leads":["leads.list","leads.create","leads.update"],"quotes":["quotes.list","quotes.create","quotes.update","quotes.send","quotes.ai_price_suggestion"],"jobs":["jobs.list","jobs.create","jobs.update","jobs.complete","jobs.send_eta","jobs.profit_summary"],"invoicing":["invoicing.generate","invoicing.chase","invoicing.recovery"],"cashflow":["cashflow.forecast"],"reviews":["reviews.request","reviews.platforms"],"services":["services.list","services.create","services.update"],"analytics":["analytics.financials","analytics.detailed","analytics.dashboard"],"reminders":["reminders.create","reminders.list"],"comms":["comms.list","comms.send_sms","comms.send_email"],"clients":["clients.list"],"billing":["billing.usage","billing.status","billing.list_plans","billing.create_checkout","billing.get_portal"],"ecosystem":["ecosystem.referral_link"],"webhooks":["webhooks.subscribe","webhooks.unsubscribe","webhooks.list"],"subcontractors":["subcontractors.list","subcontractors.register","subcontractors.dispatch","subcontractors.verify"],"compliance":["compliance.generate_swms"],"marketing":["marketing.strategy","marketing.generate_content"],"pricebook":["pricebook.search","pricebook.import"],"payments":["payments.send_link"],"formation":["formation.guided_setup","formation.recommend_trade","formation.simulate_business","formation.requirements","formation.checklist","formation.funding","formation.demand_hotspots","formation.location_score"],"lifecycle":["lifecycle.assess"],"hiring":["hiring.capacity_analysis","hiring.readiness_score","hiring.cost_calculator","hiring.apprentice_workflow","hiring.compliance_checklist"],"funding":["funding.eligibility_scan","funding.program_details"],"scaling":["scaling.readiness_score"],"operator":["operator.switch_company","operator.get_portfolio","operator.get_shared_suppliers","operator.dashboard"],"integrations":["integrations.list_connections","integrations.sync","integrations.push_entity","integrations.connection_status","integrations.available_providers"],"wallet":["wallet.balance","wallet.deposit","wallet.history","wallet.transfer","wallet.crypto_deposit"]},"spec_compliance":{"version":"2024-11-05","stateless":true,"session_id":false,"initialize_handshake":"legacy-supported","server_discover":true,"mcp_method_header":true,"mcp_name_header":true,"json_schema_2020_12":true,"deprecated_features":["roots","sampling","logging"]},"a2a_notes":{"stateless":"Fully stateless — 2026-07-28 RC compliant. No Mcp-Session-Id. No initialize handshake required. Each request carries its own auth via Bearer token.","discovery":"Use server/discover for capability probing. Legacy initialize still accepted for backward compatibility.","batch":"JSON-RPC 2.0 batch requests supported — send an array of request objects.","routing":"Responses include Mcp-Method and Mcp-Name headers for gateway routing and observability.","notifications":"Notifications (requests without id) return 204 No Content.","public_discovery":"server/discover, tools/list, resources/list, and ping methods work without authentication for registry probes.","idempotency":"Read operations are naturally idempotent. Write operations use database constraints for safety.","full_lifecycle":"An agent can manage a trade business end-to-end: capture leads → quote → schedule → complete → invoice → collect reviews → track analytics."}}