@shipsite/mcp Server

आधिकारिक

स्थैतिक वेबसाइटों को तैनात करें

shipsite.sh पर देखें

दस्तावेज़

shipsite.sh

LLM के लिए स्टैटिक साइट होस्टिंग API। एक API कॉल से साइट डिप्लॉय करें। कोई git नहीं, कोई बिल्ड स्टेप नहीं, कोई डैशबोर्ड नहीं। $0.10/साइट/दिन।

shipsite.sh LLM एजेंटों को JSON के रूप में फ़ाइलें POST करके और एक लाइव URL प्राप्त करके स्टैटिक वेबसाइट डिप्लॉय करने देता है। साइटें CDN एज नेटवर्क पर HTTPS के साथ वैश्विक रूप से सर्व की जाती हैं, 24 घंटे बाद स्वतः समाप्त हो जाती हैं जब तक कि पिन न की जाएं, और लागत $0.10 प्रति साइट प्रति दिन है (दैनिक आधार पर आनुपातिक, Stripe के माध्यम से मासिक बिलिंग)। कोई निःशुल्क स्तर नहीं — किसी भी डिप्लॉय के काम करने से पहले भुगतान आवश्यक है।

API बेस URL: https://api.shipsite.sh प्रमाणीकरण: Bearer sk_live_… (खाता निर्माण को छोड़कर सभी एंडपॉइंट) महत्वपूर्ण: API कुंजियाँ केवल एक बार दिखाई जाती हैं जब बनाई जाती हैं और बाद में पुनर्प्राप्त नहीं की जा सकतीं। कुंजी को तुरंत संग्रहीत करें। यदि खो जाती है, तो कोई पुनर्प्राप्ति नहीं है — आपको प्रमाणित रहते हुए एक नई कुंजी बनानी होगी, या यदि लॉक आउट हो गए हैं तो एक नया खाता बनाना होगा। कुंजियाँ निष्क्रिय हैं (402 लौटाती हैं) जब तक Stripe चेकआउट पूरा नहीं हो जाता।

त्वरित शुरुआत:

  1. POST /v1/accounts { "email": "[email protected]" } के साथ — api_key + setup_url लौटाता है
  2. Stripe चेकआउट पूरा करने और कुंजी सक्रिय करने के लिए setup_url खोलें
  3. POST /v1/sites Authorization: Bearer sk_live_… और { "files": { "index.html": "…" } } के साथ — { "url": "https://site\_abc123.shipsite.sh" } लौटाता है

एंडपॉइंट:

  • POST /v1/accounts (कोई प्रमाणीकरण नहीं): खाता बनाएँ। बॉडी: { "email": "…" }। लौटाता है: { "api_key": "sk_live_…", "setup_url": "https://checkout.stripe.com/…", "status": "pending" }। महत्वपूर्ण: api_key केवल एक बार दिखाया जाता है — इसे तुरंत संग्रहीत करें।
  • POST /v1/sites: एक साइट बनाएँ। बॉडी: { "files": { "path": "content" }, "name": "optional-slug", "meta": {} }। टेक्स्ट फ़ाइलें स्ट्रिंग के रूप में, बाइनरी फ़ाइलें "base64:" उपसर्ग के साथ। लौटाता है: { "id": "site_…", "url": "https://….shipsite.sh", "expires_at": "…" }
  • GET /v1/sites: साइटों की सूची बनाएँ। ?limit= और ?offset= पृष्ठांकन का समर्थन करता है।
  • GET /v1/sites/:id: साइट विवरण प्राप्त करें (मेटाडेटा, फ़ाइल सूची, समाप्ति)।
  • PUT /v1/sites/:id: एक साइट अपडेट करें। बॉडी "files", "name", और/या "meta" स्वीकार करती है (कम से कम एक आवश्यक)। छोड़ी गई फ़ाइलें अपरिवर्तित रहती हैं। किसी फ़ाइल को हटाने के लिए उसे null पर सेट करें। वैनिटी स्लग जोड़ने या बदलने के लिए "name" को एक स्ट्रिंग पर सेट करें, या इसे हटाने के लिए null करें।
  • DELETE /v1/sites/:id: किसी साइट को तुरंत हटाएँ। बिलिंग रुक जाती है।
  • POST /v1/sites/:id/pin: स्वतः-समाप्ति हटाएँ। साइट तब तक बनी रहती है जब तक हटाई न जाए।
  • POST /v1/sites/:id/unpin: वर्तमान समय से 24 घंटे का TTL पुनः लागू करें।
  • GET /v1/accounts/me: खाता स्थिति और सक्रिय साइट गणना प्राप्त करें।
  • GET /v1/accounts/me/keys: खाते के लिए सभी API कुंजियाँ (सक्रिय और निरस्त) सूचीबद्ध करें।
  • POST /v1/accounts/me/keys: एक नई API कुंजी बनाएँ। पूरी कुंजी एक बार लौटाता है — इसे तुरंत संग्रहीत करें, इसे बाद में पुनर्प्राप्त नहीं किया जा सकता।
  • POST /v1/accounts/me/keys/rotate: परमाणु रूप से एक नई कुंजी बनाएँ और एक पुरानी को निरस्त करें। बॉडी: { "revoke_key_id": "key_…" } (वैकल्पिक — वर्तमान कुंजी को निरस्त करने के लिए छोड़ें)।
  • DELETE /v1/accounts/me/keys/:id: एक API कुंजी निरस्त करें। अंतिम सक्रिय कुंजी को निरस्त नहीं कर सकते।

फ़ाइल एन्कोडिंग नियम:

  • टेक्स्ट फ़ाइलें (.html, .css, .js, .svg, .json, .txt, .xml, .md): सादे स्ट्रिंग के रूप में भेजें
  • बाइनरी फ़ाइलें (.png, .jpg, .gif, .webp, .ico, .woff2, .pdf): "base64:" उपसर्ग + base64 सामग्री

साइट नाम नियम (POST /v1/sites या PUT /v1/sites/:id पर वैकल्पिक "name" फ़ील्ड):

  • 3–63 वर्ण, केवल छोटे अक्षर, संख्याएँ, और हाइफ़न
  • एक अक्षर या संख्या से शुरू और समाप्त होना चाहिए
  • कोई लगातार हाइफ़न नहीं (--)
  • वैश्विक रूप से अद्वितीय — टकराव 409 कोड "name_taken" के साथ लौटाते हैं
  • निर्माण के समय सेट किया जा सकता है या बाद में PUT के माध्यम से जोड़ा/बदला/हटाया जा सकता है
  • किसी मौजूदा साइट से नाम हटाने के लिए PUT में null पर सेट करें
  • आरक्षित नाम (उपयोग नहीं किए जा सकते): api, www, app, admin, dashboard, billing, docs, help, support, status, blog, mail, smtp, ftp, cdn, assets, static, login, signup, auth, account, accounts, settings, config, setup, test, staging, dev, prod, internal

साइट व्यवहार:

  • https://{site_id}.shipsite.sh पर सर्व की जाती है (या https://{name}.shipsite.sh यदि नामित हो)
  • index.html / के लिए और SPA फ़ॉलबैक के रूप में सर्व किया जाता है
  • सभी साइटों पर HTTPS, वैश्विक CDN, CORS: Access-Control-Allow-Origin: *
  • कोई इंजेक्टेड सामग्री नहीं — साइटें ठीक वैसे ही सर्व की जाती हैं जैसे अपलोड की गई थीं
  • 24 घंटे बाद स्वतः समाप्त हो जाती हैं जब तक कि पिन न की जाएं

सीमाएँ: 1,000 सक्रिय साइटें, 120 डिप्लॉय/घंटा, 100 फ़ाइलें/साइट, 15 MB कुल पेलोड, 5 MB प्रति फ़ाइल, 100,000 अनुरोध/साइट/दिन।

त्रुटि प्रारूप: { "error": { "code": "…", "message": "क्या गलत हुआ, क्यों, और इसे कैसे ठीक करें, इसका कार्रवाई योग्य विवरण।", "details": { … } } } सामान्य कोड: payment_required (402), rate_limited (429), validation_error (400), not_found (404)।

दस्तावेज़ीकरण

  • API संदर्भ: पूर्ण एंडपॉइंट विवरण, उदाहरण, और फ़ाइल एन्कोडिंग नियम
  • सेवा की शर्तें: स्वीकार्य उपयोग नीति, DMCA प्रक्रिया, निषिद्ध सामग्री

MCP सर्वर

  • @shipsite/mcp: Claude Code, Cursor, और Windsurf के लिए MCP सर्वर पैकेज

MCP कॉन्फ़िग: { "mcpServers": { "shipsite": { "command": "npx", "args": ["@shipsite/mcp"], "env": { "SHIPSITE_API_KEY": "sk_live_…" } } } }

उपकरण: deploy_site, list_sites, get_site, delete_site, pin_site, unpin_site, rename_site, create_account, get_account, list_keys, create_key, rotate_key, revoke_key

वैकल्पिक