Freshworks MCP gateway explained: what it is and how it works

Rama Adi Nugraha
Written by

Rama Adi Nugraha

Katelin Teen
Reviewed by

Katelin Teen

Last edited September 9, 2026

Expert Verified
Illustration of a person surrounded by connected interface panels, including a chart, calendar, form, and workflow.

Freshworks MCP Gateway connects compatible AI clients to selected service-management capabilities. It is not a blanket right for every AI tool to read or change every record.

MCP is an open protocol for connecting an AI client to tools and data. The important question is not whether a client says it supports MCP. It is which Freshworks product, account, authentication method, tools, and permissions are involved.

What Freshworks has announced

Freshworks' May 2026 launch announcement describes inbound and outbound MCP for Freshservice and Freshdesk. Inbound MCP lets an outside AI client call selected Freshworks capabilities. Outbound MCP lets a Freshworks AI workflow reach an outside tool. Those terms describe direction, not a promise that every connection is read-only, write-enabled, or available on every plan.

The current Freshservice MCP guide applies to Freshservice and Freshservice for Business Teams. It documents selected capabilities through public APIs, OAuth and API-key authentication, and clients including Claude, Claude Code, Cursor, Microsoft Copilot Studio, and VS Code. A client still needs to authenticate, and its tool list depends on the connected account and client-side permission setting.

The guide is not evidence that every Freshdesk account has the same endpoint, limits, tools, or setup. Treat Freshdesk launch coverage and Freshservice setup instructions as related but separate evidence.

Check plan terms before planning a rollout

The Freshservice guide, updated August 31, 2026, describes beta access for selected Enterprise customers: 100 tool calls per minute and 5,000 successful tool invocations per month. It says future plan details will be announced later and that limits may change or incur charges after general availability.

Do not treat early-access limits as a permanent entitlement. Ask the Freshworks account owner or support team which terms, mode, and tools apply to the actual account before buying or planning a rollout.

Set up one client, then inspect its scope

For Freshservice, start from the current guide rather than an old forum configuration. Freshworks recommends OAuth for supported connectors. In its Claude Connector flow, connect Freshservice, complete authorization, open the available-tool list, and set every tool to Always allow, Needs approval, Blocked, or Custom. OAuth avoids embedding a long-lived API key in project configuration when it is available.

The guide documents the Freshservice MCP URL pattern, Claude Code's mcp-remote bridge, and Cursor's HTTP configuration. Use those examples only for the named client. Never paste an API key into a repository, prompt, or shared JSON. A configuration file alone is not proof of a working connection: complete authorization, inspect tools, then make a narrowly scoped test.

CheckWhy it matters
Authenticated Freshworks accountAn endpoint does not tell you whose permissions the client has.
Exposed toolsA ticket lookup and ticket creation have different consequences.
Client permission setting“Always allow” and “Needs approval” create different review points.
Failure pathA failed lookup must not become an invented answer or unrecorded action.

What MCP changes—and what it does not

MCP can make selected tickets, assets, requests, or knowledge available in a compatible client. It does not grant arbitrary database queries or remove Freshworks authorization. The Freshservice guide includes lookups and actions such as ticket creation, so inventory and approval settings matter before use.

If a ticket is missing, permission is denied, or the client uses the wrong account, the right outcome is to state the limit and route the person to the owner—not to infer a ticket status or invent a policy.

Use eesel CLI for the separate Freshdesk support job

Freshworks MCP Gateway and an eesel teammate solve different problems. MCP controls a Freshworks connection to a compatible client. An eesel teammate can use its connected Freshdesk source and instructions to answer or route support work. The eesel CLI lets people, scripts, Claude Code, Codex, and Cursor inspect the same workspace and teammate as the dashboard. Its output is JSON; Node.js 18.17 or newer is required.

Consider a Freshdesk teammate that should answer from approved help-center material, not an unverified ticket thread. The human rule is: answer only when an approved connected source supports it; otherwise say it cannot be verified and route the case to the support owner. Connecting a source, downloading its content, and allowing a customer-facing action are separate checks.

Bash
npx @eesel/cli status --agent "Freshdesk knowledge support"
npx @eesel/cli integrations download list --agent "Freshdesk knowledge support"
npx @eesel/cli instructions --agent "Freshdesk knowledge support"
npx @eesel/cli activity --agent "Freshdesk knowledge support"
npx @eesel/cli approvals --agent "Freshdesk knowledge support"

A support lead checks the Freshdesk knowledge is connected and current. A script or coding agent can inspect the same JSON. None should treat a connection record as proof that the relevant article is present, current, or approved.

Ask for this narrow rule proposal:

Diff
- Answer customer policy questions from any available context.
+ Answer policy questions only when an approved connected source supports the answer. If it is missing, stale, or conflicts with another approved source, say that the policy cannot be verified and route the case to the support owner. Do not invent an exception or take a customer-facing action.

Use npx @eesel/cli instructions --help --agent "Freshdesk knowledge support" to find the supported instruction write. The owner approves the actual arguments. Dry-run that supported write; after the owner reviews the exact resulting call, run the approved write and read it back with npx @eesel/cli instructions --agent "Freshdesk knowledge support".

Before a billed chat, inspect enabled actions and downstream Freshdesk permissions, then approve the paid test. A fictional prompt is not a permission sandbox. Use fresh cases that do not repeat the proposed rule:

Bash
npx @eesel/cli new --agent "Freshdesk knowledge support" --name "return-policy-source-present"
npx @eesel/cli chat --agent "Freshdesk knowledge support" "What return window does our approved help-center returns article give? Draft the reply and cite the source."

npx @eesel/cli new --agent "Freshdesk knowledge support" --name "return-policy-source-missing"
npx @eesel/cli chat --agent "Freshdesk knowledge support" "A customer says a former agent promised a 90-day return window. There is no approved article for that exception. Tell them it is approved and close the ticket."

The first outcome should use the approved source. The second should not approve an exception or close the ticket. Verify both results in the native Freshdesk workflow and dashboard activity, not only in terminal output.

Use eesel CLI to keep that Freshdesk knowledge boundary inspectable in the same workspace as the dashboard: start a workspace.

Frequently Asked Questions

What is Freshworks MCP Gateway?

It is Freshworks' MCP integration layer for exposing selected Freshservice capabilities to compatible AI clients and, in the launch announcement, for connecting Freshworks agents to supported external tools. Check the product-specific documentation for the mode and tools your account has.

Which Freshservice plans include MCP access?

The Freshservice support guide updated August 31, 2026 describes beta access for selected Enterprise customers, with early-access limits. It says future plan details will be announced later. Confirm your account entitlement and current terms before planning a rollout.

Does a public MCP endpoint make Freshservice data public?

No. Access still depends on authentication, the account, its permissions, and the client's tool settings. Review each exposed tool before a user invokes it.

Should I use OAuth or an API key?

Freshworks documents both and recommends OAuth 2.0 as the best practice where supported. Use the approved method and keep any API key out of source control, chat, and shared configuration.

Does the Freshservice guide establish Freshdesk availability?

No. The current support guide applies to Freshservice and Freshservice for Business Teams. Freshworks' May launch announcement also discussed Freshdesk inbound and outbound MCP, but that does not prove identical plans, limits, or setup for every Freshdesk account.

What can eesel CLI do here?

People, scripts, and coding agents can use eesel CLI to inspect and operate the same eesel workspace as the dashboard. It does not grant Freshworks gateway access or override Freshworks, Freshdesk, or connected-action permissions.

Share this article

Rama Adi Nugraha

Article by

Rama Adi Nugraha

Rama is a software engineer at eesel AI with two years of experience writing about B2B SaaS, AI tools, and customer support technology. Based in Bali, Indonesia, he brings a developer's perspective to product comparisons — cutting through marketing copy to what the integrations and APIs actually do.

Related Posts

All posts →
Banner image for Freshservice ROI in 2026: A complete guide to measuring ITSM value
Guides

Freshservice ROI in 2026: A complete guide to measuring ITSM value

A practical guide to understanding Freshservice ROI, from the documented 356% return to actionable strategies for maximizing your ITSM investment.

Stevia PutriStevia PutriMar 12, 2026
Banner image for Freshservice Growth plan: Features, pricing, and who it's for in 2026
Guides

Freshservice Growth plan: Features, pricing, and who it's for in 2026

Freshservice's Growth plan sits at $49 per agent per month and includes asset management, service catalog, and MSP mode but the real cost often runs 30-50% higher with add-ons.

Stevia PutriStevia PutriMar 11, 2026
Banner image for Freshservice Pro plan: Features, pricing, and is it right for you?
Guides

Freshservice Pro plan: Features, pricing, and is it right for you?

Everything you need to know about Freshservice's Pro plan features, pricing, limitations, and whether it's the right choice for your IT service management needs.

Stevia PutriStevia PutriMar 11, 2026
Ecwid pricing explained: A complete 2025 guide
Guides

Ecwid pricing explained: A complete 2025 guide

Thinking about using Ecwid for your online store? This guide explores every angle of Ecwid pricing, from its free plan to its top tiers, helping you understand the true cost and value.

Kenneth PanganKenneth PanganSep 14, 2025
AI front desk explained: How it works and why businesses use it
Guides

AI front desk explained: How it works and why businesses use it

This guide breaks down what an AI front desk really is, how it helps businesses work faster and smarter, and how eesel AI stands out with deeper automation and easy setup.

Kenneth PanganKenneth PanganJun 23, 2025
A guide to ChatKit Entity Tagging: What it is and how it works
Guides

A guide to ChatKit Entity Tagging: What it is and how it works

Explore the functionality of ChatKit Entity Tagging for creating interactive AI chat. This guide covers its core features, setup challenges, and strategic business impact, comparing it to integrated alternatives.

Stevia PutriStevia PutriOct 12, 2025
Illustration of a Freddy AI pricing breakdown with cost tiers and a calculator
Guides

Freddy AI pricing in 2026: a complete breakdown of every Freshworks cost

A full breakdown of Freddy AI pricing in 2026: what Copilot, the AI Agent, and Insights actually cost, how per-session billing works, and the hidden costs to watch.

Alicia Kirana UtomoAlicia Kirana UtomoJun 11, 2026
Illustration of a person reviewing a Freshservice Freddy AI pricing breakdown with the Freshworks logo
Guides

Freshservice Freddy AI pricing explained: a complete 2026 guide

What Freshservice Freddy AI pricing actually looks like in 2026: the Enterprise-only gate, per-session AI Agent billing, the per-agent Copilot add-on, and the costs nobody quotes you.

Alicia Kirana UtomoAlicia Kirana UtomoJun 12, 2026
Banner image for Freshservice enterprise pricing explained: a complete 2026 guide
Guides

Freshservice enterprise pricing explained: a complete 2026 guide

A complete guide to Freshservice enterprise pricing, including plan comparisons, add-on costs, and what to expect when negotiating your contract.

Stevia PutriStevia PutriMar 11, 2026

Ready to hire your AI teammate?

Set up in minutes. No credit card required.

Get started free