MCP server

Flyra MCP Server

Model Context Protocol server for Flyra, the CRM for home service and door-to-door businesses. 476 tools covering customers, jobs, scheduling, invoicing, payments, SMS and door-knocking map pins. Connect it to Claude, ChatGPT, Cursor or any MCP-compatible client and the assistant works directly in your account.

Server endpoint

URL
https://mcp.flyra.io/mcp
Transport
Streamable HTTP
Authentication
Authorization: Bearer flr_live_…
MCP spec
2025-11-25
Tools
476
Permission scopes
41

How to connect Claude, ChatGPT or Cursor to Flyra

  1. 1. Create an API key in Flyra at Settings then Developer. The key carries your own access and nothing more.
  2. 2. Add the server to your client. Claude Code and Cursor read the block below from their MCP config; Claude Desktop takes the same object in its developer settings; ChatGPT adds it as a connector by URL.
  3. 3. Ask for something. “Book Tuesday morning for the Hendersons and text them the confirmation” is one turn.
{
  "mcpServers": {
    "flyra": {
      "type": "http",
      "url": "https://mcp.flyra.io/mcp",
      "headers": {
        "Authorization": "Bearer flr_live_YOUR_KEY"
      }
    }
  }
}

What people actually ask it

Real requests, and the tools each one runs through. Every tool named here exists.

“An import left "UNC (solar deal)" stuck on 2,000 customer names — strip it and tag them all”

flyra_filter_customers → flyra_bulk_update → flyra_bulk_tag_customers

“Book the Hendersons in for Tuesday morning and text them the confirmation.”

flyra_find_open_slot → flyra_create_job → flyra_send_sms

“Who knocked the most doors last week, and what was their close rate?”

flyra_list_map_pins → flyra_get_employee_stats

“Turn the estimate I sent the Delgados into an invoice and charge the card on file.”

flyra_get_estimate → flyra_convert_estimate_to_invoice → flyra_charge_invoice

“Draw a territory around the new subdivision and give it to Marcus.”

flyra_create_territory → flyra_list_employees

“Text everybody we pinned as a revisit on Oak Street that we are back Thursday.”

flyra_list_map_pins → flyra_send_sms_blast

“Add Priya as a Technician and send her the setup link.”

flyra_invite_employee → flyra_list_custom_roles

“Resend Mike’s invite and make sure he gets the onboarding checklist when he signs in.”

flyra_resend_employee_invite → flyra_add_employees_to_onboarding → flyra_list_employees

“Jordan left today. Take away his access but leave tomorrow’s jobs assigned.”

flyra_deactivate_employee → flyra_list_employees

“What did we invoice last month, and how much of it is still unpaid?”

flyra_list_invoices → flyra_metrics

“Put every customer within two miles of this job on the autumn gutter plan.”

flyra_customers_within_radius → flyra_create_subscription

“Raise the price of a standard exterior clean by ten percent.”

flyra_list_services → flyra_update_service

What an agent can do with 476 tools

Customers, leads and intake forms65 tools

Create, search and import customers, move leads through a pipeline, tag records, run the referral program, track QR code yard signs, build the public intake forms that capture new enquiries, choose which pipeline each Facebook (Meta) instant form feeds, and report lead stages back to Meta.

flyra_add_customer_contact · flyra_add_customer_note · flyra_add_customer_property · flyra_add_lead_note · flyra_add_tag_to_customer · flyra_attach_customer_photo · flyra_attach_file · flyra_convert_customer_to_lead · flyra_convert_lead · flyra_create_customer · flyra_create_lead · flyra_create_lead_form · flyra_delete_customer_tag · flyra_delete_lead_form · flyra_disconnect_google_ads · flyra_export_customers · flyra_filter_customers · flyra_get_customer · flyra_get_customer_activity · flyra_get_customer_balance · flyra_get_lead · flyra_get_lead_form · flyra_get_lead_integrations · flyra_get_referral_link · flyra_get_referral_settings · flyra_get_referral_stats · flyra_global_search · flyra_import_customers · flyra_lead_for_customer · flyra_link_lead_to_customer · flyra_list_customer_contacts · flyra_list_customer_properties · flyra_list_form_submissions · flyra_list_lead_forms · flyra_list_lead_sources · flyra_list_leads · flyra_list_meta_form_routes · flyra_list_pipelines · flyra_list_qr_codes · flyra_list_referrals · flyra_list_tags · flyra_list_yard_signs · flyra_mark_referral_reward_paid · flyra_mark_yard_sign_collected · flyra_publish_lead_form · flyra_remove_customer_contact · flyra_remove_customer_property · flyra_remove_tag_from_customer · flyra_run_lead_automations · flyra_search_customers · flyra_select_google_ads_account · flyra_set_meta_conversion_reporting · flyra_set_meta_form_route · flyra_set_up_yard_sign_form · flyra_set_yard_sign_type · flyra_undo_customer_import · flyra_unpublish_lead_form · flyra_update_customer · flyra_update_customer_contact · flyra_update_customer_property · flyra_update_customer_tag · flyra_update_lead_form · flyra_update_lead_stage · flyra_update_referral_settings · flyra_update_yard_sign_settings

Catalogue, pricing and company settings83 tools

Read and edit the service catalogue and its prices, pipelines and stages, roles, their permissions and which jobs and customers each one sees, cancellation reasons, invoice settings, the files every estimate carries, and organisation-level settings.

flyra_add_checklist_template_item · flyra_add_estimate_default_attachment · flyra_cancel_subscription · flyra_change_subscription_template · flyra_create_checklist_group · flyra_create_custom_role · flyra_create_lead_source · flyra_create_payment_method · flyra_create_pipeline · flyra_create_pipeline_stage · flyra_create_service · flyra_create_subscription · flyra_create_subscription_plan · flyra_delete_category · flyra_delete_checklist_group · flyra_delete_checklist_template_item · flyra_delete_custom_role · flyra_delete_lead_source · flyra_delete_payment_method · flyra_delete_pipeline · flyra_delete_pipeline_stage · flyra_delete_revenue_goal · flyra_delete_service · flyra_delete_subscription · flyra_disconnect_stripe · flyra_edit_checklist_template_item · flyra_get_billing_plan · flyra_get_email_settings · flyra_get_employee_stats · flyra_get_invoice_settings · flyra_get_message_settings · flyra_get_org_settings · flyra_get_phone_provisioning · flyra_get_role_access · flyra_get_role_sidebars · flyra_get_subscription_link · flyra_list_cancellation_reasons · flyra_list_checklist_groups · flyra_list_custom_roles · flyra_list_employees · flyra_list_estimate_default_attachments · flyra_list_payment_methods · flyra_list_pipeline_stages · flyra_list_services · flyra_list_subscription_templates · flyra_list_subscriptions · flyra_manage_cancellation_reason · flyra_pause_subscription · flyra_remove_estimate_default_attachment · flyra_rename_checklist_group · flyra_reorder_categories · flyra_reorder_services · flyra_resume_subscription · flyra_send_subscription · flyra_set_checklist_group_auto_add · flyra_set_estimate_background · flyra_set_invoice_background · flyra_set_pipeline_stage_outcome · flyra_set_revenue_goal · flyra_set_role_access · flyra_set_role_sidebar · flyra_set_service_photo · flyra_set_subscription_auto_charge · flyra_set_subscription_crew · flyra_set_subscription_salespeople · flyra_submit_business_verification · flyra_update_custom_role · flyra_update_email_settings · flyra_update_estimate_settings · flyra_update_invoice_settings · flyra_update_lead_source · flyra_update_message_settings · flyra_update_org_settings · flyra_update_payment_method · flyra_update_pipeline · flyra_update_pipeline_stages · flyra_update_service · flyra_update_subscription_amount · flyra_update_subscription_frequency · flyra_update_subscription_item_tax · flyra_update_subscription_items · flyra_update_subscription_requirements · flyra_update_subscription_schedule

Invoicing, estimates, payments and payroll101 tools

Raise estimates and convert them to invoices, charge a saved card or send the customer a card-on-file link, record expenses, manage recurring subscriptions, work the Save Center, and read employee payroll and commission.

flyra_add_job_tip · flyra_add_payroll_bonus · flyra_approve_estimate · flyra_archive_subscription_template · flyra_attach_estimate_photo · flyra_attach_saved_card_to_subscription · flyra_charge_invoice · flyra_charge_invoice_amount · flyra_charge_job · flyra_close_save_request_cancelled · flyra_convert_estimate_to_invoice · flyra_create_discount · flyra_create_estimate · flyra_create_estimate_mockup · flyra_create_expense · flyra_create_invoice · flyra_create_subscription_template · flyra_decline_estimate · flyra_delete_estimate · flyra_delete_expense · flyra_delete_invoice · flyra_delete_payment · flyra_delete_subscription_template · flyra_delete_time_entry · flyra_duplicate_subscription_template · flyra_edit_invoice · flyra_edit_timesheet · flyra_export_estimates · flyra_export_expenses · flyra_export_jobs · flyra_export_payments · flyra_export_payroll · flyra_export_reviews · flyra_export_subscriptions · flyra_export_timesheets · flyra_export_unpaid · flyra_get_agreement_template · flyra_get_contract_library · flyra_get_employee_hours · flyra_get_employee_payroll · flyra_get_estimate · flyra_get_estimate_link · flyra_get_expense_summary · flyra_get_invoice · flyra_get_invoice_link · flyra_get_pay_rates · flyra_get_pay_statement · flyra_get_payment_method_link · flyra_get_payment_reminder_run · flyra_get_payouts · flyra_get_payroll · flyra_get_payroll_settings · flyra_get_processing_fee_setting · flyra_get_timesheet · flyra_import_expenses · flyra_list_agreement_templates · flyra_list_customer_payment_methods · flyra_list_discounts · flyra_list_estimates · flyra_list_expenses · flyra_list_invoices · flyra_list_payments · flyra_list_quality_checks · flyra_list_save_center · flyra_mark_invoice_paid · flyra_mark_pay_period_paid · flyra_preview_mark_paid · flyra_preview_payment_reminders · flyra_record_job_payment · flyra_refund_payment · flyra_remove_customer_payment_method · flyra_request_cancellation · flyra_review_quality_check · flyra_send_estimate · flyra_send_estimate_to_customer · flyra_send_invoice · flyra_send_invoice_to_customer · flyra_send_payment_method_link · flyra_send_payment_receipt · flyra_send_payment_reminders · flyra_set_agreement_defaults · flyra_set_contract_library · flyra_set_default_customer_payment_method · flyra_set_employee_tips_visible · flyra_set_invoice_split_payment · flyra_set_job_pay_override · flyra_set_pay_rate · flyra_set_period_pay_override · flyra_set_plan_processing_fee · flyra_set_service_foot_rate · flyra_set_upline · flyra_undo_expense_import · flyra_update_estimate · flyra_update_expense · flyra_update_linear_foot_pay · flyra_update_pay_period_and_commission · flyra_update_payment · flyra_update_processing_fee_setting · flyra_update_save_request · flyra_update_subscription_agreement · flyra_update_subscription_template

Jobs, scheduling and dispatch57 tools

Book, reschedule, cancel and restore jobs, find an open slot, check an employee’s availability, assign a crew, plan a day’s route, check equipment in and out, and attach job photos and checklists.

flyra_add_job_checklist_item · flyra_attach_job_photo · flyra_book_appointment · flyra_cancel_appointment · flyra_cancel_job · flyra_check_availability · flyra_check_out_equipment · flyra_create_equipment · flyra_create_hour_preset · flyra_create_job · flyra_delete_equipment · flyra_delete_hour_preset · flyra_disconnect_google_calendar · flyra_edit_job_checklist_item · flyra_edit_job_line_items · flyra_find_open_slot · flyra_get_employee_availability · flyra_get_google_calendar_status · flyra_get_job · flyra_get_job_checklist · flyra_get_job_supplies · flyra_get_route_plan · flyra_get_schedule · flyra_import_jobs · flyra_job_assign_employee · flyra_job_unassign_employee · flyra_list_appointments · flyra_list_equipment · flyra_list_equipment_checkouts · flyra_list_hour_presets · flyra_list_job_photos · flyra_list_route_plans · flyra_list_voice_memos · flyra_log_job_complaint · flyra_make_job_recurring · flyra_mark_checklist_item · flyra_mark_equipment_serviced · flyra_optimize_route · flyra_publish_route_plans · flyra_record_job_supplies · flyra_remove_job_checklist_item · flyra_rename_route_plan · flyra_repeat_employee_week · flyra_reschedule_appointment · flyra_restore_job · flyra_return_equipment · flyra_save_employee_hours · flyra_schedule_callback · flyra_search_jobs · flyra_set_employee_availability · flyra_set_equipment_photo · flyra_set_job_line_item_taxable · flyra_set_job_line_item_upsell · flyra_transition_job_status · flyra_update_equipment · flyra_update_job · flyra_update_route_stop

Door knocking, pins and territories27 tools

Drop and update map pins with a disposition, define pin types, draw and assign rep territories, review knocking sessions, and find customers within a radius. This is the part no other field service CRM exposes.

flyra_add_map_pin_photo · flyra_create_map_pin · flyra_create_objection · flyra_create_pin_type · flyra_create_territory · flyra_customers_within_radius · flyra_delete_map_pin · flyra_delete_objection · flyra_delete_pin_type · flyra_delete_territory · flyra_export_map_pins · flyra_get_map_pin · flyra_get_territory · flyra_list_default_pins · flyra_list_knocking_sessions · flyra_list_live_locations · flyra_list_map_pins · flyra_list_objections · flyra_list_pin_types · flyra_list_territories · flyra_measure_area · flyra_pins_in_territory · flyra_set_default_pin_type · flyra_update_map_pin · flyra_update_objection · flyra_update_pin_type · flyra_update_territory

Messaging, email, voice and reviews62 tools

Send a text from the business number, cancel a scheduled text, read an email thread, connect the business's own email domain and check its DNS records, look up a call, run an SMS blast to a map shape with follow-ups, read and post in team chat, and request or read customer reviews.

flyra_add_review · flyra_approve_sms_credit_purchase · flyra_block_phone_number · flyra_cancel_scheduled_message · flyra_cancel_sms_blast_followup · flyra_check_email_domain · flyra_connect_email_domain · flyra_create_quick_reply · flyra_create_team_conversation · flyra_delete_quick_reply · flyra_disconnect_email_domain · flyra_export_conversation · flyra_get_call · flyra_get_call_receivers · flyra_get_email_domain · flyra_get_email_thread · flyra_get_phone_call_settings · flyra_get_phone_menu · flyra_get_review · flyra_get_sms_blast_settings · flyra_get_sms_credits · flyra_get_team_messages · flyra_get_thread · flyra_get_voicemail_greeting · flyra_hang_up_call · flyra_list_blocked_numbers · flyra_list_calls · flyra_list_conversations · flyra_list_email_threads · flyra_list_lines · flyra_list_quick_replies · flyra_list_reviews · flyra_list_sms_blast_followups · flyra_list_sms_blasts · flyra_list_team_conversations · flyra_mark_thread_read · flyra_preview_sms_blast · flyra_reply_email_thread · flyra_reply_to_thread · flyra_search_messages · flyra_send_email · flyra_send_email_domain_records · flyra_send_review_request · flyra_send_sms · flyra_send_sms_blast · flyra_send_team_message · flyra_set_call_forwarding · flyra_set_call_outcome · flyra_set_call_receivers · flyra_set_call_recording · flyra_set_caller_id_name · flyra_set_email_domain_primary · flyra_set_outbound_call_line · flyra_set_sms_blast_autorecharge · flyra_set_spam_screening · flyra_set_voicemail_greeting · flyra_transfer_call · flyra_turn_on_sms_blast_autorecharge · flyra_unblock_phone_number · flyra_update_call_notes · flyra_update_phone_menu · flyra_update_quick_reply

Team and access36 tools

Invite somebody to the company or resend their invite, put people on their role’s onboarding, change an employee’s role, phone number or customer-facing bio, switch access on or off, read the leaderboard and run sales sprints, and create, send, follow up or void team contracts. Inviting, role changes and access switches need a signed-in Admin or Owner: an organisation API key alone cannot add people or grant Admin.

flyra_add_employee_file · flyra_add_employees_to_onboarding · flyra_archive_sales_sprint · flyra_create_team_contract · flyra_deactivate_employee · flyra_delete_sales_sprint · flyra_delete_sales_team · flyra_get_employee_live_location · flyra_get_leaderboard · flyra_get_notification_preferences · flyra_get_sales_stats · flyra_get_team_contract · flyra_invite_employee · flyra_list_api_keys · flyra_list_sales_sprints · flyra_list_sales_teams · flyra_list_team_contracts · flyra_reactivate_employee · flyra_remind_team_contract · flyra_resend_employee_invite · flyra_revoke_api_key · flyra_save_sales_sprint · flyra_save_sales_team · flyra_send_team_contract · flyra_set_employee_bio · flyra_set_employee_email · flyra_set_employee_file_expiry · flyra_set_employee_live_location · flyra_set_employee_name_and_color · flyra_set_employee_phone · flyra_set_employee_photo · flyra_set_employee_role · flyra_set_notification_preference · flyra_set_sprint_prizes · flyra_update_leaderboard_settings · flyra_void_team_contract

Tasks, automations and metrics40 tools

Create reminders, build, edit, copy and delete automations, file them into folders and turn them on or off, approve or discard the messages they hold for approval, send events to other apps and sign or test webhooks, manage custom fields, and read the revenue, operational, lead-source, retention and customer metrics behind the dashboard and reports.

flyra_approve_automation_message · flyra_archive_custom_field · flyra_copy_automation_steps · flyra_create_automation_folder · flyra_create_task · flyra_create_webhook_subscription · flyra_delete_automation · flyra_delete_automation_folder · flyra_delete_task · flyra_disable_automation · flyra_discard_automation_message · flyra_duplicate_automation · flyra_enable_automation · flyra_get_automation · flyra_get_automation_graph · flyra_get_automation_results · flyra_get_task · flyra_leads_report · flyra_list_automation_approvals · flyra_list_automation_folders · flyra_list_automations · flyra_list_custom_fields · flyra_list_tasks · flyra_list_webhooks · flyra_metrics · flyra_move_automations_to_folder · flyra_preview_automation_run · flyra_rename_automation_folder · flyra_run_automation · flyra_save_automation · flyra_save_custom_field · flyra_set_webhook_secret · flyra_set_custom_field_values · flyra_share_automation_link · flyra_snooze_automation · flyra_test_inbound_webhook · flyra_test_run_automation · flyra_update_automation · flyra_update_task · flyra_update_task_status

Multi-company access1 tools

One token can reach every Flyra company the person belongs to. This tool lists them by name so the agent can pass the right one.

flyra_list_organizations

Cleaning up records in bulk3 tools

Fix or remove many records in one call instead of one at a time: strip leftover text out of thousands of imported names, retag a whole segment, delete a bad import. Selecting records by filter always previews the count and a sample first and changes nothing until that preview is confirmed, and every entity keeps its own guardrails — an invoice with a payment on it, or an accepted estimate, is refused and reported rather than quietly deleted.

flyra_bulk_delete · flyra_bulk_tag_customers · flyra_bulk_update

Telling us what is missing1 tools

When an assistant cannot do what was asked because no tool exists for it, this sends the request to the Flyra product team in the user’s own words. It reads nothing and changes nothing.

flyra_report_gap

The server also implements the search and fetch pair that ChatGPT deep research expects, so it works as a research connector as well as an action one.

What it will not do

  • A key is scoped to one person’s access. The agent can only reach what that person can reach, across every Flyra company they belong to.
  • Nothing is exposed that the person could not do in the app. There is no admin bypass and no cross-tenant read.
  • Destructive calls still obey the same rules as the UI, so a delete the app refuses is refused here too.
  • The server does not send marketing email, and SMS goes out on your own business number under the same carrier rules as the app.

Questions

What is the Flyra MCP server?
It is a Model Context Protocol server that gives an AI assistant direct access to a Flyra CRM account. Flyra is the CRM for home service and door-to-door businesses, covering window cleaning, pressure washing, gutters and similar trades. The server exposes 476 tools over Streamable HTTP at https://mcp.flyra.io/mcp, implementing MCP spec 2025-11-25.
How do I connect Claude to my CRM?
Generate an API key at Settings then Developer inside Flyra, then add the server to your client's MCP configuration with the URL https://mcp.flyra.io/mcp and an Authorization header of "Bearer" followed by your key. Claude Code and Cursor take an mcpServers block; Claude Desktop takes the same object in its developer settings. The full configuration is on this page.
What can an AI agent actually do with Flyra?
Book, reschedule and cancel jobs; create customers and leads; raise estimates and convert them to invoices; charge a saved card; send a text from the business number; drop map pins with a door-knocking disposition; draw rep territories; read payroll and commission; and turn workflow automations on and off. There are 476 tools in total across 11 areas.
Is there an MCP server for field service or home service software?
Flyra's is one. It is unusual in covering the door-to-door side as well as the job side: map pins, pin dispositions and rep territories are exposed as tools, and most field service products have no feature for those at all, let alone an API for them.
How is access controlled?
By bearer token, with 41 distinct permission scopes such as jobs:read and invoices:write. A key carries the access of the person who created it and nothing more, so the agent can never reach data that person could not open in the app themselves. Keys are created and revoked at Settings then Developer.
Does it work with ChatGPT deep research?
Yes. Alongside the Flyra tools the server implements the search and fetch pair that ChatGPT's deep research expects, so it can be added as a connector and used to research across a Flyra account rather than only to take actions in it.
Is the Flyra MCP server free?
It is included with a Flyra subscription at no extra cost, on every plan. You need a Flyra account to generate a key; there is no separate charge for API or MCP access.

Spec 2025-11-25 · Streamable HTTP · 476 tools · 41 scopes · org-scoped per key · Flyra · Docs