Elfsight

Elfsight — MCP Server

This repository holds the documentation and the registry manifest (server.json) of the

Elfsight MCP server. The server itself is hosted by Elfsight; there is nothing to

build or run here. For help, contact Elfsight Help Center.

A remote Model Context Protocol server over your Elfsight workspace. Point an MCP-capable AI agent at it and it can browse your apps, projects and widgets, create widgets from templates, change their settings, publish them and hand you the install code — without you clicking through the Dashboard.

The server is workspace-scoped: when you sign in, you pick one Elfsight workspace, and the agent can reach only the apps, projects and widgets of that workspace.

Server URL: https://mcp.elfsight.com/mcp (Streamable HTTP).

Connect

Sign-in is OAuth. Add the server URL to your MCP client; the client opens a browser window, you sign in to Elfsight, choose the workspace and approve access. There is no key to copy.

Claude (claude.ai, Desktop, mobile)

In Claude, open Settings → Connectors, choose Add custom connector and enter the server URL https://mcp.elfsight.com/mcp, then sign in to Elfsight and approve access. On Team and Enterprise plans an organization Owner may need to add the connector first.

Claude lists nine tools as read-only and six as write tools; on the connector's page you choose for each group whether Claude asks before calling it.

Claude Code

claude mcp add --transport http elfsight https://mcp.elfsight.com/mcp

Then run /mcp inside Claude Code and choose Authenticate for elfsight.

Cursor

This repository is also a Cursor plugin: the manifest is in .cursor-plugin/plugin.json, the server connection in mcp.json, and a rule with usage notes for the agent in rules/.

To connect without the plugin, add the server to .cursor/mcp.json and authenticate it when Cursor prompts:

{

"mcpServers": { "elfsight": { "url": "https://mcp.elfsight.com/mcp" } } }

Cline

In Cline, open MCP Servers → Remote Servers and add:

• Server Name: elfsight
• Server URL: https://mcp.elfsight.com/mcp
• Transport: Streamable HTTP

Then choose Authenticate for the server and sign in to Elfsight in the browser.

The same in Cline's own settings file, cline_mcp_settings.json. Recent versions keep it in ~/.cline/data/settings/, older ones in the editor's User/globalStorage/saoudrizwan.claude-dev/settings/. Keep type: without it Cline falls back to the legacy SSE transport. .vscode/mcp.json belongs to VS Code's built-in MCP support; Cline does not read it.

{

"mcpServers": { "elfsight": { "type": "streamableHttp", "url": "https://mcp.elfsight.com/mcp" } } }

Other clients

Any client that supports remote MCP servers with OAuth (dynamic client registration and PKCE) should connect with the server URL alone.

VS Code: or add it to .vscode/mcp.json:

{

"servers": { "elfsight": { "type": "http", "url": "https://mcp.elfsight.com/mcp" } } }

Windsurf (mcp_config.json):

{

"mcpServers": { "elfsight": { "serverUrl": "https://mcp.elfsight.com/mcp" } } }

What you can ask it

Reads:

• `list_app_catalog` — "Which Elfsight apps are there?"
• `list_account_apps` — "Which apps do I have in my workspace?"
• `list_projects` — "List my projects."
• `list_widgets` — "Show my Instagram Feed widgets in the Landing project."
• `get_widget` — "What are the current settings of widget ?"
• `get_widget_limit` — "How many more Google Reviews widgets can I create?"
• `list_widget_templates` — "What templates does the Pricing Table app have?"
• `get_install_code` — "Give me the embed code for this widget."
• `get_widget_edit_links` — "Give me the link to edit this widget in the Dashboard."

Writes:

• `create_widget` — "Create a Countdown Timer from the Black Friday template."
• `duplicate_widget` — "Make a copy of this widget."
• `rename_widget` — "Rename it to Homepage reviews."
• `update_widget_settings` — "Change the header text and the accent color."
• `publish_widget` — "Publish the changes."
• `discard_widget_changes` — "Throw away the unpublished changes."

How widget changes work

• Widgets are created from templates. create_widget needs an app alias and an active template of that app (from list_widget_templates). The new widget is published right away; when the app's widget limit is reached it is saved as a draft (status: DRAFT).
• Settings changes are drafts until published. update_widget_settings applies a JSON Merge Patch to the unpublished revision: objects merge, null removes a key, arrays are replaced as a whole. The site keeps showing the published version until publish_widget is called; discard_widget_changes drops the draft. The draft is shared with the Dashboard editor, so publishing or discarding also covers any unpublished edits you made there.
• The publish link publishes on open. get_widget_edit_links returns editUrl and publishUrl; opening publishUrl in a browser where you are signed in to Elfsight publishes the draft immediately.
• Sensitive settings are protected. Each app declares restricted settings (secrets, connected accounts and similar). Changes to them are rejected; edit those in the Dashboard.
• Nothing is deleted. The server has no tool that deletes widgets or projects.

Privacy

Everything a tool returns can be sent to your AI provider (Anthropic, OpenAI, etc.) as part of your conversation with the agent. Widget settings contain whatever you put in your widgets — texts, links, images and, for some apps, contact details. Treat tool results accordingly.

Limits and rate limiting

• list_widgets and list_widget_templates return pages of up to 100 items (page, itemsPerPage).
• Requests are rate-limited per client: 60 tool calls per minute. Going over the limit returns a 429 with a Retry-After header — wait and retry.

Support

Questions or issues — contact Elfsight Help Center or your account manager.