# MCP and skills

> Connect your coding agent to Sypnia so it can ask what is failing in production, read what it needs to fix it, and set Sypnia up for you.

Applies to: the Sypnia engine (open source, self-hosted) and Sypnia Cloud (paid service). Status: at launch.  
Source: https://docs.sypnia.com/mcp/

For agents: Start here to connect a coding agent to Sypnia: the MCP server (remote, self-hosted, local stdio), its ten tools, the two agent skills (sypnia-setup, sypnia-fix), examples and security.

**\[Engine]** **\[Cloud]** Sypnia hands the fix to the agent that wrote the code. This section is how: an **MCP server** your coding agent can ask, and **skills** that teach it to work with Sypnia.

> **In plain words**
>
> MCP is a standard way for a coding agent (Cursor, Claude Code and others) to use outside tools. Connect Sypnia once, and from then on you can type «what is failing in production?» and your agent looks it up, reads the cause, and fixes the code. A skill is a short instruction file that tells the agent how to do a job well, such as adding Sypnia to your project.

**Claude Code**

1. Add the Sypnia skills:
   ```bash
   claude plugin marketplace add sypnia/skills
   claude plugin install sypnia@sypnia
   ```
2. Connect the MCP server:
   ```bash
   claude mcp add --transport http sypnia \
     https://mcp.sypnia.com/mcp \
     --header "Authorization: Bearer YOUR_API_TOKEN"
   ```

Then say: «Set up Sypnia in this project».

**Cursor**

1. Add the Sypnia skills: In Cursor, open **Customize**, choose **From GitHub Repository** and import `sypnia/skills`.
2. Connect the MCP server:

   `.cursor/mcp.json`
   ```json
   {
     "mcpServers": {
       "sypnia": {
         "url": "https://mcp.sypnia.com/mcp",
         "headers": {
           "Authorization": "Bearer ${env:SYPNIA_API_TOKEN}"
         }
       }
     }
   }
   ```

Then say: «Set up Sypnia in this project».

**Any agent**

1. Paste this prompt:
   ```text
   Read https://docs.sypnia.com/llms.txt and follow the quickstart it points to. Add Sypnia to this project: install @sypnia/browser, call init() with my project key (ask me for it), and tell me how to check that the first session arrived.
   ```

An agent with no skills or MCP support can still read every page: each one is plain Markdown at its address plus `.md`.

## What your agent can do

| You say                          | Your agent calls                                | It gets                                                                                                |
| -------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| «What is failing in production?» | `health`                                        | The open problems that hit the most people, checks that are down, pages that got slower                |
| «Fix the pay button problem»     | `problem`, then `resolve_problem` after the fix | The cause with its evidence, the stack with source lines, what the person did, the trace, what changed |
| «What did this customer see?»    | `search`, `sessions`, `session`                 | The session, step by step, without anything typed                                                      |
| «Why is the search page slow?»   | `performance`                                   | The page's numbers and the element behind each one                                                     |
| «Set up Sypnia in this project»  | The `sypnia-setup` skill                        | The SDK installed, the key from an environment variable, source maps in the build, a first check       |

The server reads. Its one write is marking a problem resolved, and you can switch that off. It never merges code and never returns replay recordings.

## Where it runs

|                                       | Sypnia engine (open source, self-hosted)       | Sypnia Cloud (paid service, with a free tier) |
| ------------------------------------- | ---------------------------------------------- | --------------------------------------------- |
| Remote server                         | Served by your engine at `<your base URL>/mcp` | `https://mcp.sypnia.com/mcp`                  |
| Local server (\`@sypnia/mcp\`, stdio) | Yes. It calls your engine's API                | Yes. It calls the Cloud API                   |
| Tools                                 | All ten                                        | All ten                                       |
| Skills                                | Yes                                            | Yes                                           |

## In this section
