tilda-mcp — Claude Code MCP server: Tilda projects and pages
Connects the Tilda API to your AI agent: project and page lists, page HTML and CSS, export for self-hosting.
claude mcp add tilda-mcp -e TILDA_PUBLIC_KEY=<TILDA_PUBLIC_KEY> -- npx -y @theyahia/tilda-mcpWhat tilda-mcp does
This server puts your Tilda sites inside the agent. Ask which pages a project holds and when each went live, and the answer comes back as a table with dates. There are 7 tools, one per Tilda API method: projects list, project details with a sample htaccess or nginx config, pages list, a full page with <head>, body only, and two export calls that bring localised assets along.
Page tools accept metadata_only: true, which returns just the metadata and skips html, css and js. Handy when a page is large. Whole-project export has no single call: run get_pages, then get_page_export for every id.
You need the public and secret keys from your Tilda account, passed as TILDA_PUBLIC_KEY and TILDA_SECRET_KEY. The Tilda API only reads keys from query parameters, so keep them out of unencrypted proxies and logs. The API allows 150 requests per hour; the client retries with growing delays and honours Retry-After. An HTTP mode is available too (--http --port 3001, endpoint http://localhost:3001/mcp), and it keeps no session state.
What it helps with
- list the pages in a Tilda project with their publish dates
- pull a page's HTML and CSS so the assistant can suggest edits
- export a page with its assets for your own hosting
- get a web server config for a project's domain
- read metadata of a big page without spending context on markup
Example prompts for the agent
- Show my Tilda projects
- List pages of project 12345 with publish dates
- Export page 67890 for my own hosting
How to install tilda-mcp
Platform CLI
claude mcp add tilda-mcp -e TILDA_PUBLIC_KEY=<TILDA_PUBLIC_KEY> -- npx -y @theyahia/tilda-mcpReplace <…> with your own values
Platform CLI
codex mcp add tilda-mcp --env TILDA_PUBLIC_KEY=<TILDA_PUBLIC_KEY> -- npx -y @theyahia/tilda-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"tilda-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/tilda-mcp"
],
"env": {
"TILDA_PUBLIC_KEY": "<TILDA_PUBLIC_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tilda-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/tilda-mcp"
],
"env": {
"TILDA_PUBLIC_KEY": "<TILDA_PUBLIC_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TILDA_PUBLIC_KEY=<TILDA_PUBLIC_KEY> tilda-mcp npx -y @theyahia/tilda-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about tilda-mcp
How do I install tilda-mcp in Claude Code?
Run claude mcp add tilda-mcp -e TILDA_PUBLIC_KEY=<TILDA_PUBLIC_KEY> -- npx -y @theyahia/tilda-mcp. Supply the key as an environment variable rather than inline in the request text.
What does tilda-mcp do?
It gives the agent data from your site through the Tilda API: projects, pages with publish dates, full page HTML and CSS, plus export with localised assets.
What is required to run the server?
A public and a secret key from your Tilda account settings. The server cannot authorise against the API without them.
