Famysync
Skip to article

MCP connections and tools

Search Famysync documentation

Search the full guides for topics such as renewal, ticket alerts, OAuth or knowledge refresh.

Connect an agent with OAuth or a token and use the 11 available tools.

On this page

Connect an agent

  1. Copy the MCP URL from Dashboard → API & Agents.
  2. Add it as a remote server/connector in your MCP client.
  3. If the client uses OAuth, sign into Famysync, review the workspace and requested permissions, then approve.
  4. If using a token, configure the bearer header through the client’s secure credential mechanism.
  5. Refresh the client’s tools and request list_bots.
  6. Confirm the returned bots belong to the intended workspace before asking the agent to change anything.
https://api-uat.famysync.com/mcp

Available tools

Tools are filtered by the connection/token’s scopes. There is no create_bot MCP tool. Regional reports, chat summaries, team, billing and full dashboard configuration are not regular MCP tools.

One connection covers one workspace: the one open in the dashboard when you approved it. To use another workspace, switch to it and connect again. update_instructions needs the settings:write permission; connections approved before it existed must connect again to get it.

ToolRequired scopePurpose
list_botsbots:readList the bots of the workspace this connection was approved for, with each bot’s default language.
list_knowledgekb:readList knowledge 50 at a time (limit/offset), with address, status, last sync and failure reason; filter by chatbotId, status, type or q.
add_knowledgekb:writeQueue a URL or text with a title.
delete_knowledgekb:writeDelete a knowledge document by id (cannot be undone).
list_custom_answerskb:readList custom answers (they take priority over other knowledge).
add_custom_answerkb:writeAdd a custom answer to a bot.
update_custom_answerkb:writeChange a custom answer; returns the previous text.
delete_custom_answerkb:writeDelete a custom answer.
get_bot_settingsbots:readRead a bot’s instructions, persona, fallback message and language settings.
update_instructionssettings:writeReplace instructions, persona and/or fallback message; returns the previous settings.
ask_botchat:invokeAsk a question using the bot’s knowledge. Returns sources, suggested questions and a sessionId to continue; saved as an mcp conversation.
list_conversationsconversations:readFind recent conversations with optional q/chatbotId/channel.
get_conversationconversations:readRead one sessionId transcript.
list_leadsleads:readRead intent-scored leads.
get_analyticsanalytics:readRead aggregate 30-day metrics.
list_bookingsbookings:readRead appointment requests.
get_bookingbookings:readRead one bookingId.
update_bookingbookings:writeConfirm, reject, reschedule or cancel a booking.

Example tasks

  • “List my bots, then show the recent questions for the support bot.”
  • “Read the last 30 days of aggregate analytics for this bot and summarize recurring unanswered questions.”
  • “Show pending bookings. Ask me before confirming, rejecting or changing one.”
  • “Add this approved FAQ text to the selected bot and report the queued result.”

Disconnect or recover

OAuth connections appear under MCP connections in API & Agents. Disconnect the relevant connection there to revoke access. Remove it from the client too if it should no longer be configured. Token-based connections are revoked by revoking their API token.

  • No tools: check scope, plan/live access and whether the client completed authentication.
  • Wrong bots: inspect the authorized workspace and token allowlist.
  • Expired/revoked credentials: reconnect or replace the token as appropriate.
  • Payment suspension: restore service access before repeating login attempts.

Related guides

Something unclear? Tell us.

Start free trial