FASS MCPDocs
FASS MCP

Run your business from an AI agent

FASS MCP is a Model Context Protocol server. Connect it to Claude — or any MCP client — and an AI agent can operate your FASS workspace end‑to‑end: stand up an AI receptionist, give it a phone number, teach it, book appointments, pull matched federal solicitations, and run the whole front of a bid — price it against real DoD award history, decide GO/TEAM/SKIP, and draft the proposal. No dashboard, no API keys to paste.

Model Context Protocol OAuth 2.1 46 tools Multilingual Included with every plan

What can I actually do?

You never call these tools yourself. You tell Claude what you want in plain English, and it chains the right tools together. For example, in a single prompt:

“Create a receptionist for my dental office from my website, purchase a local phone number, teach it my office hours, and start booking appointments.”

Claude will automatically:

Connecting Google Calendar is a one‑time setup in your FASS connectors. After that, every booking lands on your calendar automatically — and everything above happens right inside your chat with Claude.

Or point it at a bid on your board and let it run the whole front of the pursuit in one prompt:

“Should I bid the Army Corps electrical job on my pipeline — and if it’s worth it, draft the proposal.”

Claude will automatically:

One command, the whole bid front. That single prompt runs pursue_bid, which chains benchmark_award_prices, should_i_bid, and write_proposal_document — grounded in 19k+ historical DoD awards. It stops before drafting on SKIP, so no hours are wasted on a bid you can’t win.

Overview

The FASS MCP server exposes your workspace as a set of tools an AI agent can call on your behalf. It speaks JSON‑RPC over HTTP at a single endpoint and authenticates with OAuth 2.1, so a client like Claude can discover it, sign you in, and start working — no key management.

POST https://api.fass.systems/api/v1/voice/mcp

Every tool is scoped to the businesses on your own account, and write actions (texting a lead, buying a number, booking) default to approval‑required in the client, so nothing happens without your say‑so.

Quickstart

In Claude, add FASS as a custom connector. The whole handshake takes about 30 seconds.

Open Settings → Connectors → Add custom connector in Claude.
Paste the FASS MCP endpoint: https://api.fass.systems/api/v1/voice/mcp
Claude opens the FASS sign‑in. Approve it — this is standard OAuth, there is no key to copy.
The tools appear, scoped to your workspace. Try: “list my FASS businesses.”
Already have Voice or Flow? The connector attaches to the same account and login — nothing new to set up.

Authentication

FASS MCP is a full OAuth 2.1 authorization server. Clients that support MCP OAuth (like Claude) do the entire flow automatically:

If a request arrives without a valid token, the endpoint returns 401 with a WWW-Authenticate challenge that points the client at discovery — which is what triggers the sign‑in prompt.

# A tool call, once authenticated
POST /api/v1/voice/mcp
Authorization: Bearer <token>
{
  "jsonrpc": "2.0", "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_business",
    "arguments": { "name": "Parenting Law", "timezone": "America/New_York" }
  }
}

Tools reference

46 tools, grouped by what they do. Optional parameters are marked ?. When you have one business, business_id can be omitted and FASS uses it automatically.

Provisioning

ToolParametersWhat it does
create_businessname, website?, timezone?Create a new receptionist line in preview. Pass a website to auto‑write the greeting and script.
set_agentbusiness_id, greeting?, voice?, timezone?, languages?, system_prompt?Configure how the line answers — including the languages it speaks.
provision_numberbusiness_id, area_code?, contains?Buy a phone number and take the line live. Purchases a real number.
Multilingual calls. Pass languages to set_agent or create_business — e.g. "English, Spanish". The AI auto‑detects the caller's language on the call and answers in it, and can switch mid‑call. Spoken support today: English, Spanish, French, Portuguese, German, Italian.

Knowledge

ToolParametersWhat it does
set_faqbusiness_id, question?, answer?, faqs?Teach the line question→answer pairs it uses on calls.
update_knowledgebusiness_id, note?, facts?Add facts (hours, services, pricing, policies).
list_knowledgebusiness_idRead back the facts and FAQ the line currently uses.

Booking

ToolParametersWhat it does
get_availabilitybusiness_id, date_from?, date_to?, duration_minutes?Open slots in business hours, minus already‑booked and Google‑Calendar‑busy times.
book_appointmentbusiness_id, contact, start, name?, duration_minutes?, purpose?Book a slot. Rejects double‑bookings at the database level and syncs to your Google Calendar.

Flow & govcon

ToolParametersWhat it does
list_solicitationsonly_open?, limit?Federal/state solicitations matched to your workspace (title, commodity, deadline, link).
email_solicitation_digestonly_open?Email a digest of matched solicitations to your own account email — never anyone else.
generate_grantpath_reportbusiness_name, naics?, state?, certifications?, email?Build a personalized GrantPath report — federal contracts (SAM.gov) + grants (Grants.gov) matched to the business, ranked with a plain‑English "why it fits" — email the PDF and land the matches on your pipeline.
generate_contractpath_reportbusiness_name, naics?, state?, certifications?, email?Win‑focused report: open solicitations to bid on now, plus the recompetes on the horizon to position for. Emails the PDF and syncs to your pipeline.
generate_proposalbusiness_name, title, solicitation_number?, agency?, naics?, set_aside?, deadline?, description?, email?Draft a full federal Technical & Price Proposal (cover, exec summary, approach, personnel, past performance, compliance matrix) for one solicitation and email the PDF.
render_grantpath_reportspec, email?Render an agent‑researched report spec into the branded FASS PDF template.
pursue_opportunitiesbusiness_name, naics?, state?, track?, max?, email?Autopilot: scan live opportunities, draft a full proposal for each strong fit, land them on your pipeline, and deliver. The hands‑off trigger.
get_business_profileRead the government‑contracting profile that drives every match & proposal: NAICS codes, certifications, SAM UEI, CAGE, core competencies, differentiators, past performance, size.
update_business_profilenaics_codes?, certifications?, sam_uei?, cage_code?, core_competencies?, differentiators?, company_name?, service_type?, website?, phone?, address?, …Correct the profile so matching and drafted bids are accurate. Only the fields you pass change.

Pipeline control

ToolParametersWhat it does
list_pipelinestage?, limit?See the bid board grouped by stage (flagged → scored → pursuing → submitted → awarded → passed): id, title, agency, deadline, NAICS, score, value.
read_proposalproposal_idRead the FULL content of one bid — captured solicitation text, R‑E‑A‑D worksheet, drafted sections — so an agent can review or improve it.
list_duewithin_days?The bids that need attention — overdue or due within N days (default 7), excluding awarded/passed. Nearest deadline first.
triage_pipelinestage?, limit?Score & tag every board opportunity prime / sub / ignore for winnability (SaaS fit, subcontract‑friendly, repeat buyer; penalizes past‑performance gaps & unheld set‑asides). Persists the tags.
read_proposal_documentproposal_idOpen a bid in the Proposal Editor and read its full drafted content as text, plus the linked solicitation and edit count.
write_proposal_documentproposal_id, markdown, note?Draft or rewrite a bid's content (markdown → the editor doc). Creates the document if missing and records the change in history.
list_proposal_historyproposal_id, limit?The edit history / audit trail of one proposal — who changed what and when.
move_pipeline_itemproposal_id, stageMove an item to another stage/column — this is how an agent partitions the board.
update_pipeline_itemproposal_id, title?, agency?, due_date?, naics_code?, estimated_value?, status?Fix an item's details so the board is correct. Only the fields you pass change.
delete_pipeline_itemproposal_idPermanently remove a junk/duplicate item. Deletes a real row — cannot be undone.
Agent‑controlled pipeline. With these an AI can keep your bid board correct end‑to‑end: “Show my pipeline, move the two overdue food‑service bids to passed, and delete the duplicate SolarWinds entry.” Every pipeline tool is scoped to your own user_id at the database level — an agent can only touch your board, never anyone else's.

Estimator & bid intelligence

ToolParametersWhat it does
benchmark_award_pricesnaics, state?, estimate?Price a bid against what actually won at DoD: award count, median winning amount, the p25–p75 competitive band, top buying agencies, and where your estimate lands vs. real winners. Real federal award data, not a guess.
should_i_bidnaics, state?, estimate?, agency?Answer “should we even pursue this?” before hours are spent. Combines the award benchmark (market depth + price fit) with your business profile (NAICS/cert fit) into a transparent GO / TEAM / SKIP call with plain‑English reasons. Decision support, not a guaranteed probability.
pursue_bidproposal_id, estimate?, draft?One‑command bid engine. Point it at a pipeline item and it runs the whole front of the bid end to end: benchmarks the price → should_i_bid GO/TEAM/SKIP → flags risks (price out of band, thin market, deadline, missing SOW) → and, if it’s worth it, drafts a full proposal into the Proposal Editor linked to the bid. Stops before drafting on SKIP so no hours are wasted.
The estimator as an expert, not a screen. An agent can reason about pricing and bid/no‑bid directly — “For this Army Corps electrical job in Maryland, what won historically and should we bid at $250k?” (benchmark_award_prices → should_i_bid) — or run the entire front of the bid in one call: pursue_bid benchmarks, risk‑checks, and drafts the proposal into the editor. Grounded in 19k+ historical DoD awards.

Read & act

ToolParametersWhat it does
list_businessesYour lines, with phone number and live/preview status.
list_callsbusiness_id?, limit?Recent calls: time, caller, duration, outcome.
list_leadsbusiness_id?, limit?Captured leads: caller, callback, need, urgency.
list_messagescontact, business_id?The SMS thread with one contact.
send_smsto, body, business_id?Send a real text from a business line.
list_followupsOpen follow‑ups in your CRM.
create_followupsubject, name?, phone?, kind?Create a follow‑up task.
create_meeting_linkbusiness_id?A shareable video meeting link anyone can join in a browser.
get_usageBusinesses, calls answered, leads captured.

Sales team — staff only

These work the new‑registrant call queue and are role‑gated: only accounts whose profile role is admin, manager, or rep can call them. Everyone else gets a polite refusal. Each is scoped to the signed‑in rep.

ToolParametersWhat it does
list_sales_leadspool?, track?, state?, limit?Leads from the call queue. pool = mine, new, due, or unclaimed.
get_sales_leadueiFull detail on one lead — contact, decision‑maker, status, consent, recent activity.
draft_lead_outreachuei, channel?Draft a personalized call opener, email, or text for a lead around the right FASS product. Drafts only — sends nothing.
claim_leadueiAssign a lead to you. Refuses if another rep holds it.
log_sales_outcomeuei, outcome, note?, follow_up_hours?, dq_reason?Record a call result (no_answer / talked / sent_link / meeting / nurture / disqualify), advance status, set follow‑ups.
set_lead_consentuei, sourceRecord outreach consent (verbal_on_call / inbound_callback / written) before any automated messaging.
my_sales_statsYour scoreboard: pipeline, the dials→connects→links→paid funnel, rates, and estimated commission.
Claude as a sales assistant. A rep can say “Pull my due follow‑ups, and for the top one draft me a text and log that I sent the link.” (list_sales_leads → draft_lead_outreach → log_sales_outcome)

Use cases

Because the tools compose, one instruction can chain several. A few things you can just ask for:

Security & tenancy

Pricing

Included with every FASS plan — no separate MCP fee.

The connector operates on your existing FASS workspace. You pay for FASS Voice, Flow, or the FASS Suite bundle as usual; calls, phone numbers, and usage bill through your plan. There is no per‑call MCP surcharge and no developer add‑on.

PlanWhat you getMCP access
FASS VoiceAI receptionist on your lineIncluded
FASS FlowGovcon capture + solicitation matchingIncluded
FASS Suite — $399/moVoice Pro + Flow Core + one more capabilityIncluded

Get started →  ·  See the FASS Suite bundle →