Tilda MCP Server

README.md

# MCP-сервер для Tilda API — 7 инструментов для ИИ-агента: проекты, страницы, экспорт

Если вы искали, как подключить сайт на Tilda к Claude или другому ИИ-агенту, — этот сервер отдаёт агенту ваши проекты и страницы через Tilda API: список страниц с датами публикации, полный HTML и CSS любой страницы, экспорт проекта целиком. Спрашиваете «что за страницы в проекте и когда их публиковали» — агент отвечает таблицей, а не ссылкой на документацию. Нужны только публичный и секретный ключи из настроек Tilda.

[![npm](https://img.shields.io/npm/v/@theyahia/tilda-mcp)](https://www.npmjs.com/package/@theyahia/tilda-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

![Демонстрация: вопрос «что за страницы в проекте и когда их публиковали» — агент вызывает get_pages и отвечает таблицей страниц с датами](https://raw.githubusercontent.com/theYahia/WWmcp/main/servers/tilda/assets/demo.svg)

Часть серии [WWmcp](https://github.com/theYahia/WWmcp) (46 серверов) by [@theYahia](https://github.com/theYahia).

## Установка

### Claude Desktop

```json
{
  "mcpServers": {
    "tilda": {
      "command": "npx",
      "args": ["-y", "@theyahia/tilda-mcp"],
      "env": { "TILDA_PUBLIC_KEY": "your-public-key", "TILDA_SECRET_KEY": "your-secret-key" }
    }
  }
}
```

### Claude Code

```bash
claude mcp add tilda -e TILDA_PUBLIC_KEY=your-public-key -e TILDA_SECRET_KEY=your-secret-key -- npx -y @theyahia/tilda-mcp
```

### VS Code / Cursor

```json
{ "servers": { "tilda": { "command": "npx", "args": ["-y", "@theyahia/tilda-mcp"], "env": { "TILDA_PUBLIC_KEY": "your-public-key", "TILDA_SECRET_KEY": "your-secret-key" } } } }
```

### Streamable HTTP

```bash
TILDA_PUBLIC_KEY=xxx TILDA_SECRET_KEY=yyy npx @theyahia/tilda-mcp --http --port 3001
# Endpoint: http://localhost:3001/mcp  (stateless, CORS включён)
# Health:   http://localhost:3001/health  → {"status":"ok","tools":7}
```

HTTP-режим работает в **stateless**-режиме: на каждый POST создаётся свежий сервер+транспорт (подходит для чистой API-обёртки, поддерживает несколько клиентов без коллизий сессий). Принимает `POST`/`OPTIONS` на `/mcp`; прочие методы → `405`.

### Smithery

```bash
npx @smithery/cli install @theyahia/tilda-mcp
```

> Требуется `TILDA_PUBLIC_KEY` и `TILDA_SECRET_KEY`. Получите в [настройках аккаунта Tilda](https://tilda.cc/identity/apikeys/).

## Инструменты (7)

Полное покрытие всех 7 методов Tilda API.

| Инструмент | Метод API | Описание |
|------------|-----------|----------|
| `get_projects` | `getprojectslist` | Список проектов |
| `get_project_info` | `getprojectinfo` | Информация о проекте (домен, настройки экспорта). Опц. `webconfig=htaccess\|nginx` → пример конфига веб-сервера |
| `get_pages` | `getpageslist` | Список страниц проекта |
| `get_page` | `getpagefull` | Полная страница (HTML c `<head>`, CSS, JS; ссылки на Tilda CDN) |
| `get_page_body` | `getpage` | Только тело страницы (HTML без `<head>`; ссылки на CDN) — для быстрого чтения/preview |
| `get_page_export` | `getpagefullexport` | Экспорт полной страницы с локализованными ассетами `{from,to}` — для самостоятельного хостинга |
| `get_page_export_body` | `getpageexport` | Экспорт тела страницы с локализованными ассетами — для вставки в свой шаблон/CMS |

**Экономия контекста:** инструменты страниц (`get_page*`) принимают опц. `metadata_only: true` — вернуть только метаданные без `html`/`css`/`js` (полезно для больших страниц).

**Экспорт всего проекта:** отдельного метода нет — получите `get_pages`, затем по каждому `id` вызовите `get_page_export` (или `get_page_export_body`).

> **Лимит Tilda API:** 150 запросов в час. Клиент делает ретраи с экспоненциальной задержкой и учитывает заголовок `Retry-After`.

> **Безопасность:** Tilda API принимает ключи только как query-параметры (`publickey`/`secretkey`) — это особенность самого API. Сервер не логирует URL с ключами; держите ключи в env, не передавайте их в незашифрованные логи/прокси.

## Скиллы

| Скилл | Триггер |
|-------|---------|
| `/skill-get-pages` | Покажи все страницы сайта |
| `/skill-export-page` | Экспортируй страницу |

## Примеры

```
Покажи мои проекты в Tilda
Информация о проекте 12345 с конфигом nginx
Список страниц проекта 12345
Покажи содержимое страницы 67890
Покажи только метаданные страницы 67890
Экспортируй страницу 67890 для своего хостинга
Экспортируй тело страницы 67890 для вставки в шаблон
```

## Лицензия

MIT

---

Часть [WWmcp](https://github.com/theYahia/WWmcp) · Telegram: [@vhodvai](https://t.me/vhodvai)

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.6/5.0

Scored 2026-07-28 07:41 across 7 tools

Disambiguation4/5

Most tools have clearly distinct purposes: listing vs. details, full page vs. body vs. export. However, get_page and get_page_export both return full HTML but differ in asset localization, which could cause some confusion.

Naming Consistency5/5

All tools follow a consistent get_<resource> or get_<resource>_<modifier> pattern in snake_case, with clear and predictable naming.

Tool Count5/5

With 7 tools covering project info, page listing, and various export formats, the set is well-scoped without being too sparse or overpopulated.

Completeness2/5

The tools are thoroughly read-only, covering retrieval and export but lacking any create, update, or delete operations for projects or pages, which is a significant gap for a typical CMS integration.

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Related Servers