Tesseron
Enables MCP-compatible AI agents to execute typed live-app actions over WebSocket, allowing agents to directly interact with real application state without browser automation or scraping.
What is Tesseron?
Tesseron is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables mcp-compatible ai agents to execute typed live-app actions over websocket, allowing agents to directly interact with real application state without browser automation or scraping.
Enables MCP-compatible AI agents to execute typed live-app actions over WebSocket, allowing agents to directly interact with real application state without browser automation or scraping.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables MCP-compatible AI agents to execute typed live-app a
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @tesseron/mcpManual Installation
npx -y @tesseron/mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Tesseron
Tesseron is an MCP gateway that lets AI agents execute typed, schema-validated actions directly against live application state over WebSocket — without browser automation, DOM scraping, or screenshot analysis. A Tesseron-aware app (browser or Node.js) opens a loopback WebSocket and registers its actions using the Tesseron SDK; the MCP gateway discovers them and bridges them to any MCP client such as Claude Code or Cursor. This means agents can add a todo, submit a form, or trigger any custom app action with real-time feedback and type safety, using framework SDKs for React, Svelte, Vue, vanilla JavaScript, and Node.js.
Prerequisites
- Node.js 18 or higher
- An application instrumented with the Tesseron SDK (@tesseron/web, @tesseron/server, or a framework adapter)
- Claude Code, Cursor, or another MCP-compatible client
- npx available for running @tesseron/mcp without a global install
Install the Tesseron SDK in your application
Add the appropriate Tesseron SDK package to your app — @tesseron/web for browser apps, @tesseron/server for Node.js, or a framework adapter for React, Svelte, or Vue.
npm install @tesseron/web
# Or for Node.js backend:
npm install @tesseron/server
# Framework adapters:
npm install @tesseron/react
npm install @tesseron/svelte
npm install @tesseron/vueInstrument your application with Tesseron actions
Register your app and define typed actions using Zod schema validation. Call tesseron.connect() to open the WebSocket connection to the MCP gateway.
import { tesseron } from '@tesseron/web';
import { z } from 'zod';
tesseron.app({ id: 'todo_app', name: 'Todo App' });
tesseron
.action('addTodo')
.input(z.object({ text: z.string().min(1) }))
.handler(({ text }) => {
state.todos.push({ id: Date.now(), text, done: false });
render();
return { ok: true };
});
await tesseron.connect();Add @tesseron/mcp to your MCP client configuration
Register the Tesseron MCP gateway with your Claude Code or other MCP client. The gateway discovers your running app via the local instances directory.
{
"mcpServers": {
"tesseron": {
"command": "npx",
"args": ["-y", "@tesseron/[email protected]"]
}
}
}Start your app and verify the connection
Run your instrumented application so the WebSocket is active. The Tesseron gateway will detect it via ~/.tesseron/instances/ and bridge it to the MCP client.
# Start your app (e.g., open in browser or run Node.js server)
# Then in Claude, ask:
# "List the available Tesseron actions for the running app"Tesseron Examples
Client configuration
Claude Code .mcp.json configuration to run the Tesseron MCP gateway via npx.
{
"mcpServers": {
"tesseron": {
"command": "npx",
"args": ["-y", "@tesseron/[email protected]"]
}
}
}Prompts to try
Use these prompts in Claude Code after the Tesseron gateway is running and your app is instrumented.
- "List all available actions in the connected Tesseron app"
- "Add a new todo item with the text 'Review Tesseron integration' using the addTodo action"
- "Mark todo item ID 3 as complete using the Tesseron app's toggleDone action"
- "Submit the checkout form in the connected app with these values: name='Alice', email='[email protected]'"
- "Ask the app to navigate to the settings page using the navigateTo action"Troubleshooting Tesseron
The MCP gateway does not discover the running app
Tesseron discovers apps via the local file ~/.tesseron/instances/. Ensure your app called tesseron.connect() successfully — check the browser console or Node.js logs for connection errors. The app and MCP gateway must run on the same machine.
Actions fail schema validation
Ensure the input passed to an action matches the Zod schema defined in your app. Ask Claude to show you the action's input schema before invoking it, and adjust the arguments accordingly.
ctx.sample or ctx.confirm capabilities are unsupported
Sampling and elicitation capabilities are not universally supported across MCP clients. The core tool invocation capability works everywhere. Check your client's MCP capability documentation; Claude Code's support varies by version.
Frequently Asked Questions about Tesseron
What is Tesseron?
Tesseron is a Model Context Protocol (MCP) server that enables mcp-compatible ai agents to execute typed live-app actions over websocket, allowing agents to directly interact with real application state without browser automation or scraping. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Tesseron?
Install via npm with the command: npx -y @tesseron/mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Tesseron?
Tesseron works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Tesseron free to use?
Yes, Tesseron is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Tesseron Alternatives — Similar Browser Automation Servers
Looking for alternatives to Tesseron? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Tesseron in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Tesseron?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.