1Social MCP sunucusu
Commit 27 Eki 2026Instagram, TikTok, X, LinkedIn ve diğer sosyal ağlarda paylaşımlarınızı doğal dil kullanarak yayınlayın, planlayın ve yönetin.
Ayrıca bilinen adı sultanlive/1social-mcp, instagram
- Yıldızlar
- 0
- Araçlar
- 10
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.0.1
- Son commit
- 27 Eki 2026
- Lisans
- MIT
1Social MCP nedir?
Instagram, TikTok, X, LinkedIn ve diğer sosyal ağlarda paylaşımlarınızı doğal dil kullanarak yayınlayın, planlayın ve yönetin. 10 araç sunar; örneğin list_accounts, preview_post, publish_post.
Özet, projenin README dosyasından oluşturuldu
1Social MCP sunucusu hakkında
1Social MCP; yapay zeka asistanlarının doğal dil aracılığıyla sosyal medya varlıklarını yönetmelerine olanak tanıyan, OAuth ile korunan uzak bir sunucudur. Instagram, TikTok, X, LinkedIn, Bluesky, Threads, Facebook ve YouTube Shorts gibi platformlarda içerik yayınlamayı ve planlamayı kolaylaştırmak için Claude, ChatGPT, Cursor ve VS Code gibi istemcilerle bağlantı kurar. Kullanıcılar sunucuyla streamable HTTP üzerinden etkileşime girer; sistem, güvenli yetkilendirme için PKCE ile OAuth 2.1 kullanır, bu da asistanın sosyal medya kimlik bilgilerinizi asla görmeyeceği anlamına gelir.
Sunucu, çeşitli sosyal medya görevlerini yerine getirmek için on özel araç sunar. Mevcut planınızı ve kalan kotanızı kontrol etmek için list_accounts aracını kullanabilir veya herhangi bir şey yayına girmeden önce karakter sayılarını ve medya gereksinimlerini kontrol eden bir deneme sürüşü çalıştırmak için preview_post aracını kullanabilirsiniz. publish_post aracı, hem anlık paylaşımları hem de 30 güne kadar olan planlamaları yönetir. Mevcut içeriği yönetmek için sunucu; başarılı olanları etkilemeden belirli ağlardaki içerikleri güncelleme, iptal etme, silme veya başarısız gönderimleri yeniden deneme araçlarını içerir.
Neler yapabilirsiniz
- 1Platformlar arası planlamaTek bir mesajın gelecekte belirli bir zamanda birden fazla sosyal ağa gönderilmesini planlayın.
- 2İçerik doğrulamaBir paylaşımın yayınlanmadan önce farklı sosyal ağların özel karakter sınırlarına ve medya gereksinimlerine uygun olup olmadığını doğrulayın.
- 3Hedefli hata kurtarmaBaşarılı olduğu platformlara tekrar göndermeden, yalnızca başarısız olan belirli bir sosyal ağdaki paylaşımı yeniden deneyin.
- 4Paylaşım durumu denetimiDaha önce yayınlanmış içeriklerin gönderim durumunu ve etkileşim metriklerini kontrol edin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
1Social MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekle1Social MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http instagram https://mcp.1social.dev/mcp/instagram1Social MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"instagram": {
"url": "https://mcp.1social.dev/mcp/instagram"
}
}
}1Social MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"instagram": {
"type": "http",
"url": "https://mcp.1social.dev/mcp/instagram"
}
}
}1Social MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"instagram","type":"http","url":"https://mcp.1social.dev/mcp/instagram"}'1Social MCP'yi Codex içine yükleyin
$ codex mcp add instagram --url https://mcp.1social.dev/mcp/instagram1Social MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.instagram] url = "https://mcp.1social.dev/mcp/instagram"
1Social MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http instagram https://mcp.1social.dev/mcp/instagram1Social MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"instagram": {
"url": "https://mcp.1social.dev/mcp/instagram",
"type": "http"
}
}
}1Social MCP araçları 10
README dosyasından algılandılist_accountspreview_postpublish_postlist_postsupdate_postcancel_postdelete_postretry_deliveryupload_mediaconfirm_delivery
| list_accounts | — | |
| preview_post | — | |
| publish_post | — | |
| list_posts | — | |
| update_post | — | |
| cancel_post | — | |
| delete_post | — | |
| retry_delivery | — | |
| upload_media | — | |
| confirm_delivery | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirsultanlive/1social-mcp is public and reachablegithub.com/sultanlive/1social-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-27github.com/sultanlive/1social-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok10 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorHTTPS endpoint answered 401 (sign-in required)Geçti
1Social MCP
Model Context Protocol server for publishing to social networks — secured by OAuth.
1Social MCP lets an AI assistant post for you. Connect Claude, ChatGPT, Cursor, VS Code, or a CLI client to 1Social, then publish, schedule, check and fix posts across Instagram, TikTok, X, LinkedIn, Bluesky, Threads, Facebook and YouTube Shorts in natural language.
- Server URL:
https://mcp.1social.dev/mcp - Transport: Streamable HTTP
- Auth: OAuth 2.1 with PKCE and Dynamic Client Registration
- Landing & setup: 1social.dev/mcp
Install
1Social MCP is a remote, OAuth-secured server. There is no package to install and no API key to paste. Add this to your client's MCP config:
{
"mcpServers": {
"1social": {
"url": "https://mcp.1social.dev/mcp"
}
}
}
One-click install: Cursor · VS Code · Claude connectors · ChatGPT connectors
CLI clients (Claude Code, Gemini CLI, Codex CLI) and manual snippets: see Supported clients.
Quick start
- Create a 1Social account at 1social.dev.
- Connect your social accounts in the browser. This step needs a browser and cannot be done from a chat — each network's OAuth consent screen has to be signed for by you.
- Add the server to your client with the one-click link, the CLI command, or the JSON/TOML snippet above.
- Authorize with OAuth when your client opens the consent screen.
- Ask your assistant to post.
What you can do from chat
- 📤 Publish and schedule — one message goes to every network you pick, now or up to 30 days ahead.
- 🔍 Check before it goes — per-network character counts, whether an image is required, whether a multi-part post will thread natively or be joined, and what it costs against your quota.
- 🧾 Read the receipt — what reached each network, what failed and why, and what genuinely could not be determined.
- ♻️ Fix what broke — retry one network without touching the ones that already went out.
- 🖼 Attach media — post an image or video from the chat. Instagram and TikTok refuse posts without one.
- ✏️ Edit, cancel, delete — change a scheduled post, unschedule it, or delete it from the networks that allow deletion.
Tool surface
Ten tools, deliberately few. Publish-now and schedule are the same tool (scheduledAt: null means now), and reading one post is list_posts with a postId rather than a second tool — a smaller set is one a model picks from accurately.
| Tool | What it does |
|---|---|
list_accounts |
Connected accounts, what each network accepts, current plan, remaining quota. Call it first — channel ids come from here. |
preview_post |
Free dry run: per-network limits, media requirements, threading behaviour, quota cost. Nothing is published. |
publish_post |
Publishes now, or schedules up to 30 days ahead. Returns a per-network receipt. Takes an idempotencyKey. |
list_posts |
Posts with their delivery outcome per network — delivered, failed with a reason, cancelled, or unknown — plus stored engagement metrics. |
update_post |
Edits a post that has not been sent yet. The networks have no edit endpoint, so it withdraws and replaces. |
cancel_post |
Unschedules a post and releases the quota it reserved. |
delete_post |
Deletes from 1Social and attempts removal from each network. See What deletion can and cannot do. |
retry_delivery |
Retries one failed network, leaving the successful ones alone. Refused for permanent failures. |
upload_media |
Pre-signed upload target, for clients that cannot attach a file to a tool call. |
confirm_delivery |
Records your answer about a delivery whose outcome was unknown: is the post live on that network or not? |
The live set is what the server says it is — run tools/list against https://mcp.1social.dev/mcp for the exact, current shapes.
It tells you when it doesn't know
A post to four networks can land on three. Every tool result is per network: the failure is named in words you can act on, and a delivery whose outcome genuinely could not be determined comes back as unknown rather than as success.
unknown is not a dead end. You look at the network, tell the assistant what you see, and confirm_delivery settles it — confirming it is live commits the quota, confirming it is not marks the delivery failed so retry_delivery can pick it up. The assistant is not allowed to guess this on your behalf.
What deletion can and cannot do
delete_post always removes the post from 1Social. Removal from the network depends on the network:
| Network | Remote delete |
|---|---|
| X, LinkedIn, Bluesky, Facebook | ✅ works |
| Instagram, TikTok, Threads | ❌ no working delete API — the post stays live and only you can take it down |
On a multi-part thread only the first post is removed; the rest stay live as orphans. The tool reports what actually came down, per network, and the assistant is instructed to tell you that rather than confirm a clean delete.
Plans & access
Publishing costs us money per delivery, so the quota is metered in deliveries, not posts — one post to four networks is four deliveries. A delivery to X costs more units than the others because X charges per post (pricing has the current numbers).
| No subscription | Solo | Pro | |
|---|---|---|---|
| Price | $0 | $19/mo | $39/mo |
| Monthly deliveries | 30 units | 600 units | 1,600 units |
| All eight networks | ✅ | ✅ | ✅ |
| Delivery receipts & retries | ✅ | ✅ | ✅ |
A new account has a small free monthly allowance — enough to publish, watch the receipt come back, retry something, and schedule a post — so the tools work before you pay for anything. A failed delivery does not count against the quota when the failure was ours or the network's.
You never have to leave the chat to pay. A tool call that runs out of quota comes back with a checkout link for your account.
Supported clients
- Claude (web & desktop) — Settings → Connectors → Add custom connector
- ChatGPT — Settings → Apps & Connectors → Advanced → Developer mode → Add custom connector
- Cursor — one-click deeplink, or
~/.cursor/mcp.json - VS Code — one-click deeplink, or
.vscode/mcp.json - Claude Code (CLI) —
claude mcp add --transport http 1social https://mcp.1social.dev/mcp - Gemini CLI —
gemini mcp add --transport http 1social https://mcp.1social.dev/mcp - Codex CLI —
codex mcp add 1social --url https://mcp.1social.dev/mcp - Generic HTTP MCP client — point it at the URL and let it complete OAuth discovery
Full per-client instructions: docs/setup.md.
Cursor plugin
This repository is also a Cursor plugin. It contributes one MCP server (1social) and no rules, skills, agents, or hooks.
.cursor-plugin/plugin.json ← plugin manifest
mcp.json ← the MCP server it contributes
assets/logo.svg ← plugin logo
There is nothing to configure. The server advertises OAuth 2.1 metadata, Cursor registers itself dynamically, and the consent screen opens on first use.
Example prompts
Cross-post with a check first
"Draft a post about our new pricing page for LinkedIn, X and Bluesky, check it fits, then publish."
→ preview_post reports the per-network counts and cost; publish_post returns a receipt per network.
Schedule with an image
"Post this screenshot to Instagram and Threads on Friday at 9am."
→ The attached file goes in media; Instagram would have refused the post without it.
Find out what actually happened
"Did yesterday's post make it everywhere?"
→ list_posts returns the receipt — including any delivery still marked unknown.
Repair, not repost
"LinkedIn failed. Retry just LinkedIn."
→ retry_delivery touches one delivery and leaves the successful networks alone.
More: docs/examples.md.
Authorization
OAuth 2.1 with PKCE, per the MCP authorization spec. The authorization server is https://1social.dev; it supports Dynamic Client Registration, so compatible clients set themselves up and you only see the consent screen. Scopes granted are openid, profile, email and offline_access.
The assistant never sees your social credentials. Your network tokens stay in 1Social; the assistant holds only a token for your 1Social account, and you can revoke it at any time from the web app.
Flow details: docs/oauth.md.
Troubleshooting
Common connection, OAuth, and tool-call errors: docs/troubleshooting.md.
Marketplace listings
This repo is the source for two listings:
| Registry | Record | Manifest |
|---|---|---|
| MCP Registry | dev.1social/1social |
server.json — published by CI on a v* tag, authenticated by a DNS TXT record on 1social.dev |
| LobeHub | sultanlive-1social-mcp |
lhm.plugin.json — published with npx -y @lobehub/market-cli plugin publish --dir . |
The tools array in lhm.plugin.json is generated from the TOOLS table in the server's own contract (packages/contract/src/mcp/tools.ts in the private repo), the same table that answers tools/list. It is a snapshot: when the tool surface changes, regenerate it rather than hand-editing, or the listing will describe a server that no longer exists.
Note that the two registries carry different version numbers on purpose — server.json is at 0.1.0, while LobeHub assigned 1.0.0 at import time and a version cannot be renamed.
Project links
- Product: 1social.dev
- MCP page: 1social.dev/mcp
- MCP server:
https://mcp.1social.dev/mcp - OAuth issuer:
https://1social.dev - Issues: github.com/sultanlive/1social-mcp/issues
License
MIT — see LICENSE.
Built by @sultanlive. 1Social is a hosted publishing service; this repo is documentation for its public MCP server. Server source is not open.
1Social MCP soruları
1Social MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http instagram https://mcp.1social.dev/mcp/instagram komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
1Social MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
1Social MCP hangi araçları sunar?
10 araç sunar; bunlar arasında list_accounts, preview_post, publish_post, list_posts, update_post yer alır.
1Social MCP nasıl kurulur?
Herhangi bir paket kurulumu veya API anahtarı gerektirmeyen, OAuth ile korunan uzak bir sunucudur; sunucu URL'sini doğrudan istemcinizin MCP yapılandırmasına eklemeniz yeterlidir.
Paylaşımları önceden planlayabilir miyim?
Evet, paylaşımlarınızı 30 güne kadar ileri tarihli olarak planlayabilirsiniz.
Asistan sosyal medya kimlik bilgilerimi görüyor mu?
Hayır, asistan yalnızca 1Social hesabınız için bir token tutar; ağ tokenlarınız ise 1Social bünyesinde güvenli bir şekilde saklanır.
Instagram veya TikTok'taki paylaşımları silebilir miyim?
Hayır, Instagram, TikTok ve Threads platformlarının bu servis üzerinden çalışan bir silme API'si bulunmamaktadır, bu nedenle paylaşımlar yayında kalmaya devam eder.