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 176 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 176 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 39 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.

MCP server

Flyra MCP Server

Model Context Protocol server for Flyra, the CRM for home service and door-to-door businesses. 176 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.

Install & setup docs Generate a key

Server endpoint

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

How to connect Claude, ChatGPT or Cursor to Flyra

1. Create an API key in Flyra at Settings then Developer. The key carries your own access and nothing more.
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. 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

“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 176 tools

Customers, leads and intake forms29 tools

Create and search customers, move leads through a pipeline, tag records, build the public intake forms that capture new enquiries, and choose which pipeline each Facebook (Meta) instant form feeds.

flyra_add_tag_to_customer · flyra_convert_lead · flyra_create_customer · flyra_create_lead · flyra_create_lead_form · flyra_delete_lead_form · 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_list_form_submissions · flyra_list_lead_forms · flyra_lead_for_customer · flyra_list_lead_sources · flyra_list_leads · flyra_list_meta_form_routes · flyra_list_pipelines · flyra_list_tags · flyra_publish_lead_form · flyra_remove_tag_from_customer · flyra_search_customers · flyra_set_meta_form_route · flyra_unpublish_lead_form · flyra_update_customer · flyra_update_lead_form · flyra_update_lead_stage

Catalogue, pricing and company settings41 tools

Read and edit the service catalogue and its prices, pipelines and stages, roles, their permissions and which jobs and customers each one sees, and organisation-level settings.

flyra_cancel_subscription · 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_delete_custom_role · flyra_delete_lead_source · flyra_delete_payment_method · flyra_delete_pipeline · flyra_delete_pipeline_stage · flyra_delete_service · flyra_get_email_settings · flyra_get_employee_stats · flyra_get_message_settings · flyra_get_org_settings · flyra_get_phone_provisioning · flyra_get_role_access · flyra_list_custom_roles · flyra_list_employees · flyra_list_payment_methods · flyra_list_pipeline_stages · flyra_list_services · flyra_list_subscription_templates · flyra_list_subscriptions · flyra_pause_subscription · flyra_resume_subscription · flyra_set_revenue_goal · flyra_set_role_access · flyra_update_custom_role · flyra_update_email_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

Invoicing, estimates, payments and payroll36 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 and read employee payroll and commission.

flyra_charge_invoice · flyra_convert_estimate_to_invoice · flyra_create_estimate · flyra_create_expense · flyra_create_invoice · flyra_create_subscription_template · flyra_delete_estimate · flyra_delete_expense · flyra_delete_invoice · flyra_get_agreement_template · 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_payment_method_link · flyra_get_payroll · flyra_get_payroll_settings · flyra_list_agreement_templates · flyra_list_customer_payment_methods · flyra_list_estimates · flyra_list_expenses · flyra_list_invoices · flyra_mark_invoice_paid · flyra_refund_payment · flyra_send_estimate · flyra_send_invoice · flyra_send_payment_method_link · flyra_set_job_pay_override · flyra_set_pay_rate · flyra_set_period_pay_override · flyra_update_expense · flyra_update_subscription_template

Jobs, scheduling and dispatch17 tools

Book, reschedule and cancel jobs, find an open slot, check an employee’s availability, assign a crew, and attach job photos and checklists.

flyra_cancel_job · flyra_check_availability · flyra_create_job · flyra_find_open_slot · flyra_get_employee_availability · flyra_get_job · flyra_get_job_checklist · flyra_get_schedule · flyra_job_assign_employee · flyra_job_unassign_employee · flyra_list_equipment · flyra_list_job_photos · flyra_mark_checklist_item · flyra_search_jobs · flyra_set_employee_availability · flyra_transition_job_status · flyra_update_job

Door knocking, pins and territories19 tools

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

flyra_create_map_pin · flyra_create_objection · flyra_create_pin_type · flyra_create_territory · flyra_customers_within_radius · flyra_delete_map_pin · flyra_delete_pin_type · flyra_delete_territory · flyra_get_map_pin · flyra_get_territory · flyra_list_map_pins · flyra_list_objections · flyra_list_pin_types · flyra_list_territories · flyra_pins_in_territory · flyra_update_map_pin · flyra_update_objection · flyra_update_pin_type · flyra_update_territory

Messaging, email, voice and reviews14 tools

Send a text from the business number, read an email thread, look up a call, run an SMS blast to a map shape, and request or read customer reviews.

flyra_get_call · flyra_get_email_thread · flyra_get_review · flyra_get_sms_credits · flyra_get_thread · flyra_list_calls · flyra_list_conversations · flyra_list_email_threads · flyra_list_reviews · flyra_reply_to_thread · flyra_send_email · flyra_send_review_request · flyra_send_sms · flyra_send_sms_blast

Team and access4 tools

Invite somebody to the company, change an employee’s role, and switch access on or off. These four need a signed-in Admin or Owner: an organisation API key alone cannot add people or grant Admin.

flyra_deactivate_employee · flyra_invite_employee · flyra_reactivate_employee · flyra_set_employee_role

Tasks, automations and metrics11 tools

Create reminders, build and edit automations, turn them on or off, and read the revenue and operational metrics behind the dashboard.

flyra_create_task · flyra_disable_automation · flyra_enable_automation · flyra_get_automation · flyra_get_automation_graph · flyra_list_automations · flyra_list_tasks · flyra_metrics · flyra_save_automation · flyra_update_automation · 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 176 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 176 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 39 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 · 176 tools · 39 scopes · org-scoped per key · Flyra · Docs