+
+
Build a LinkedIn posting agent
+
Real code: a Claude agent that researches a topic, drafts a post, and publishes it to LinkedIn — fully automated.
+
+
+
+ What you'll build
+ A Node.js script that (1) takes a topic from the command line, (2) uses Claude to research and draft a LinkedIn post, (3) calls the SquareMCP linkedin_create_post tool to publish — all in one agentic loop.
+
+
+
Prerequisites
+
+
+
Step 1 — Install dependencies
+
npm init -y
+npm install @anthropic-ai/sdk @modelcontextprotocol/sdk
+
+
Step 2 — Create the agent
+
+
Create linkedin-agent.mjs:
+
+
import Anthropic from '@anthropic-ai/sdk' ;
+import { Client } from '@modelcontextprotocol/sdk/client/index.js' ;
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js' ;
+
+const SQUAREMCP_URL = 'https://hermes.squaremcp.com/mcp' ;
+const SQUAREMCP_TOKEN = process.env.SQUAREMCP_TOKEN ; // your Bearer token
+const topic = process.argv[2 ] ?? 'AI trends in 2026' ;
+
+// ── 1. Connect to SquareMCP ──────────────────────────────────────
+const transport = new StreamableHTTPClientTransport (new URL (SQUAREMCP_URL), {
+ requestInit: { headers: { Authorization: `Bearer ${ SQUAREMCP_TOKEN} ` } },
+});
+
+const mcpClient = new Client ({ name: 'linkedin-agent' , version: '1.0.0' });
+await mcpClient.connect(transport);
+
+// Fetch available tools from SquareMCP
+const { tools: mcpTools } = await mcpClient.listTools ();
+
+// Convert MCP tool descriptors to Anthropic tool format
+const anthropicTools = mcpTools.map (t => ({
+ name: t.name,
+ description: t.description,
+ input_schema: t.inputSchema,
+}));
+
+// ── 2. Run the agentic loop ──────────────────────────────────────
+const anthropic = new Anthropic ();
+const messages = [
+ {
+ role: 'user' ,
+ content: `You are a LinkedIn content strategist. Your job:
+1. Think about the topic: "${ topic} "
+2. Draft a compelling LinkedIn post (150-250 words, professional tone, 3-5 hashtags)
+3. Call linkedin_create_post to publish it
+4. Report back what was posted.
+
+Write the post now and publish it.` ,
+ },
+];
+
+console.log (`\n🤖 Agent starting — topic: "${ topic} "\n` );
+
+while (true ) {
+ const response = await anthropic.messages.create ({
+ model: 'claude-opus-4-7' ,
+ max_tokens: 1024 ,
+ tools: anthropicTools,
+ messages,
+ });
+
+ // Append assistant turn
+ messages.push ({ role: 'assistant' , content: response.content });
+
+ if (response.stop_reason === 'end_turn' ) {
+ const text = response.content
+ .filter (b => b.type === 'text' )
+ .map (b => b.text)
+ .join ('\n' );
+ console.log ('\n✅ Agent finished:\n' , text);
+ break ;
+ }
+
+ if (response.stop_reason !== 'tool_use' ) break ;
+
+ // Execute each tool call against SquareMCP
+ const toolResults = [];
+ for (const block of response.content) {
+ if (block.type !== 'tool_use' ) continue ;
+
+ console.log (`🔧 Calling ${ block.name} ...` );
+ let result;
+ try {
+ result = await mcpClient.callTool ({ name: block.name, arguments: block.input });
+ console.log (` ✓ ${ JSON.stringify (result.content[0 ]).slice (0 , 120 )} ...` );
+ } catch (err) {
+ result = { content: [{ type: 'text' , text: `Error: ${ err.message} ` }] };
+ console.error (` ✗ ${ err.message} ` );
+ }
+
+ toolResults.push ({
+ type: 'tool_result' ,
+ tool_use_id: block.id,
+ content: result.content,
+ });
+ }
+
+ messages.push ({ role: 'user' , content: toolResults });
+}
+
+await mcpClient.close ();
+
+
Step 3 — Run it
+
+
export ANTHROPIC_API_KEY=sk-ant-...
+export SQUAREMCP_TOKEN=your-bearer-token-here
+
+node linkedin-agent.mjs "The future of AI agents in enterprise software"
+
+
Expected output:
+
+
🤖 Agent starting — topic: "The future of AI agents in enterprise software"
+
+🔧 Calling linkedin_create_post...
+ ✓ {"id":"urn:li:share:7194...","success":true}...
+
+✅ Agent finished:
+ I've published the following LinkedIn post:
+
+"Enterprise software is undergoing a quiet revolution..."
+[full post text]
+
+The post has been published successfully to your LinkedIn feed.
+
+
Step 4 — Extend it
+
+
Now that you have the agentic loop working, you can extend it:
+
+
Post to multiple platforms at once
+
// Replace the user message with:
+content: `Draft a post about "${ topic} " and publish it on both
+LinkedIn (professional tone) and Twitter (punchy, max 280 chars, 2 hashtags).
+Use linkedin_create_post and twitter_create_tweet.`
+
+
Schedule with a cron job
+
# Post every weekday at 9am
+0 9 * * 1-5 SQUAREMCP_TOKEN=... ANTHROPIC_API_KEY=... \
+ node /path/to/linkedin-agent.mjs "$(cat /path/to/topics.txt | shuf -n1)"
+
+
React to inbound WhatsApp messages
+
Configure a webhook in the SquareMCP dashboard. When a WhatsApp message arrives, SquareMCP POSTs to your server. Run the same agent loop but start with the inbound message as context:
+
+
import express from 'express' ;
+import crypto from 'crypto' ;
+
+const app = express ();
+app.use (express.json ());
+
+app.post ('/webhook' , async (req, res) => {
+ // Verify signature
+ const sig = req.headers['x-squaremcp-signature' ];
+ const expected = `sha256=${ crypto
+ .createHmac ('sha256' , process.env.WEBHOOK_SECRET )
+ .update (JSON.stringify (req.body))
+ .digest ('hex' )} ` ;
+ if (sig !== expected) { res.status (401 ).end (); return ; }
+
+ res.status (200 ).end (); // acknowledge immediately
+
+ const { platform, data } = req.body;
+ console.log (`Inbound from ${ platform} : ${ data.text} ` );
+
+ // Run agent in background...
+ runAgent (data).catch(console.error);
+});
+
+app.listen (3000 );
+
+
Going further
+
+
+
+
+
Getting started
+
Connect your AI assistant to SquareMCP in five minutes. Choose your client below.
+
+
+
Step 1 — Create your account
+
+
+
+
Sign up at squaremcp.com
+ Open the
SquareMCP dashboard , create an account, and verify your email.
+
+
+
+ Get your access token
+ Click Connect MCP Client in the dashboard. This opens a short OAuth flow that issues a Bearer token bound to your account.
+ Copy the token shown on the confirmation page — it won't be displayed again.
+
+
+
+
+
Connect at least one platform
+ Go to
Platforms and connect LinkedIn, TikTok, WhatsApp, or any other service. See
Platform guides for step-by-step instructions per platform.
+
+
+
+
Step 2 — Configure your MCP client
+
+
+ Claude Desktop
+ Codex CLI
+ opencode
+
+
+
+
// ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
+// %APPDATA%\Claude\claude_desktop_config.json (Windows)
+{
+ "mcpServers" : {
+ "squaremcp" : {
+ "type" : "http" ,
+ "url" : "https://hermes.squaremcp.com/mcp" ,
+ "headers" : {
+ "Authorization" : "Bearer YOUR_TOKEN_HERE"
+ }
+ }
+ }
+}
+
Restart Claude Desktop after saving. You should see SquareMCP tools in the tool picker (hammer icon).
+
+
+
+
# ~/.codex/config.json
+{
+ "mcpServers" : {
+ "squaremcp" : {
+ "type" : "http" ,
+ "url" : "https://hermes.squaremcp.com/mcp" ,
+ "headers" : {
+ "Authorization" : "Bearer YOUR_TOKEN_HERE"
+ }
+ }
+ }
+}
+
Or pass inline per command:
+
codex --mcp-server squaremcp=https://hermes.squaremcp.com/mcp \
+ --mcp-header squaremcp:Authorization="Bearer YOUR_TOKEN_HERE" \
+ "Post a LinkedIn update about today's product launch"
+
+ PKCE flow (optional)
+ Codex CLI supports the full OAuth PKCE flow. Run codex auth squaremcp and follow the browser prompt — no token copy-paste required.
+
+
+
+
+
# ~/.config/opencode/config.json
+{
+ "mcp" : {
+ "servers" : {
+ "squaremcp" : {
+ "type" : "http" ,
+ "url" : "https://hermes.squaremcp.com/mcp" ,
+ "headers" : {
+ "Authorization" : "Bearer YOUR_TOKEN_HERE"
+ }
+ }
+ }
+ }
+}
+
Save the file and restart opencode. The SquareMCP tools will appear in the tool list automatically.
+
+
+
Step 3 — Verify the connection
+
Ask your AI assistant:
+
What social platforms do I have connected?
+
It should call get_profile or linkedin_get_profile and return your account details. If you see a "Platform not connected" error, revisit the Platform guides .
+
+
Available tools
+
SquareMCP exposes tools across every connected platform. A few highlights:
+
+
+
+
linkedin_create_post
+
Publish text, image, or video to your LinkedIn feed.
+
+
+
tiktok_create_video
+
Upload a video file and publish it to TikTok.
+
+
+
whatsapp_send_message
+
Send a WhatsApp message to any number via Business API.
+
+
+
twitter_create_tweet
+
Post a tweet with optional media attachment.
+
+
+
instagram_create_reel
+
Publish a reel to your Instagram Business account.
+
+
+
send_email
+
Send email from any connected IMAP/SMTP account.
+
+
+
+
See the full list in the API reference .
+
+
Troubleshooting
+
+
Tools not appearing in Claude
+
Restart Claude Desktop after editing claude_desktop_config.json. If tools still don't appear, open the Claude Desktop developer console and look for MCP connection errors.
+
+
"Platform not connected" errors
+
The tool was called but the platform isn't linked to your account. Open the dashboard and connect the platform under Platforms .
+
+
"Token expired" badge in dashboard
+
OAuth tokens for LinkedIn, TikTok, and Instagram expire. SquareMCP attempts an automatic refresh — if that fails, reconnect the platform. WhatsApp, Telegram, and Discord use long-lived bot tokens that don't expire.
+
+
Rate limit errors
+
Each SquareMCP plan has a monthly tool-call limit. Check Usage in the dashboard. Upgrade your plan if you're consistently hitting the limit.
+
+
+ Keep your Bearer token secret
+ Your Bearer token has full access to every connected platform. Treat it like a password. Rotate it from the dashboard if you suspect it's been exposed.
+
+
+
+
Build AI agents that
+
SquareMCP connects Claude, Codex CLI, and opencode to LinkedIn, TikTok, WhatsApp, Instagram, Twitter, and more — through a single MCP server.
+
+
+
+
+
Why MCP?
+
The Model Context Protocol lets AI assistants call real tools without custom integrations. Instead of writing a bespoke connector for every model and platform, you configure SquareMCP once and every MCP-compatible client gains the same 50+ tools.
+
SquareMCP is multi-tenant by design: each customer's credentials are encrypted at rest, isolated per account, and never shared across sessions. Bearer tokens issued through OAuth are bound to your customer record so every tool call is attributable and rate-limited.
+
+
Supported clients
+
+
+
Claude Desktop
+
Add a mcpServers entry to claude_desktop_config.json. No extra software needed.
+
+
+
Codex CLI
+
Pass --mcp-server or configure in ~/.codex/config.json. Full PKCE OAuth flow supported.
+
+
+
opencode
+
Add SquareMCP to your opencode MCP providers list. HTTP Bearer transport.
+
+
+
Custom agents
+
Any MCP client that supports Streamable HTTP transport works. See the agent tutorial for a from-scratch example.
+
+
+
+
Supported platforms
+
+
in LinkedInPost text, images, and video. Search connections, send messages.
+
🎵 TikTokUpload and publish videos. View creator analytics.
+
💬 WhatsAppSend messages and templates. Receive inbound via webhook.
+
📷 InstagramPublish reels and image posts via Business API.
+
𝕏 Twitter / XTweet with media. Search and read timeline.
+
f FacebookPost to pages, share photos and video.
+
✈️ TelegramSend messages and photos via bot token.
+
🎮 DiscordSend messages to channels via bot.
+
+
+
+
Platform guides
+
Step-by-step instructions for connecting each platform. Click a platform to jump to its guide.
+
+
+
+
+
+
in LinkedIn
+
+
What you can do
+
+ Post text updates, articles, images, and videos
+ Search connections and send direct messages
+ Retrieve your profile and network info
+
+
+
Connecting LinkedIn
+
+
+
+
Create a LinkedIn app
+ Go to
developer.linkedin.com/apps and create a new app. Add your company page and request the
w_member_social and
r_liteprofile products.
+
+
+
+ Generate an access token
+ Use the LinkedIn OAuth 2.0 token generator in your app dashboard, or use the 3-legged OAuth flow. Copy the access token (valid 60 days; refresh tokens extend to ~12 months).
+
+
+
+
+ Paste into SquareMCP dashboard
+ Open the SquareMCP dashboard → LinkedIn → Connect → paste your access token → Save.
+
+
+
+
+
Available tools
+
Example prompts
+
Post a LinkedIn update: "Excited to announce our new product launch!"
+
+Post a LinkedIn video from /tmp/demo.mp4 with caption "Watch our product demo"
+
+Search my LinkedIn connections for people at Anthropic
+
+Send a LinkedIn message to John Smith saying "Great meeting you at the conference"
+
+
+ Token refresh
+ LinkedIn access tokens expire after 60 days. SquareMCP will automatically attempt a refresh using the refresh token. If refresh fails (e.g., the user revokes access), reconnect from the dashboard.
+
+
+
+
🎵 TikTok
+
+
What you can do
+
+ Upload and publish videos with captions
+ Set privacy level (public, friends, private)
+ View creator info and video status
+
+
+
Connecting TikTok
+
+
+
+ OAuth via SquareMCP dashboard
+ Open the SquareMCP dashboard → TikTok → Connect. You'll be redirected to TikTok to authorise the app. SquareMCP uses TikTok Login Kit with video.publish and user.info.basic scopes.
+
+
+
+
+ Allow the requested permissions
+ TikTok shows the requested scopes. Click Authorize . You'll be redirected back to the dashboard with a "Connected" badge.
+
+
+
+
+
Uploading a video
+
Videos must be hosted at a publicly accessible URL. The tool uploads the video to TikTok's servers asynchronously — use tiktok_get_video_status to poll for completion.
+
+
Example prompts
+
Upload the video at https://cdn.example.com/demo.mp4 to TikTok
+with caption "Check out our new feature! #AI #productlaunch"
+and set privacy to PUBLIC_TO_EVERYONE
+
+Check the status of my last TikTok upload
+
+
+ TikTok sandbox vs. production
+ TikTok's Content Posting API requires app approval for production use. New apps start in sandbox mode (videos published to a test account only). Apply for production access through the TikTok developer portal.
+
+
+
+
💬 WhatsApp
+
+
What you can do
+
+ Send freeform messages and approved template messages
+ Send images, documents, and media
+ Receive inbound messages via webhook and forward to your AI agent
+ List all approved message templates
+
+
+
Prerequisites
+
You need a WhatsApp Business Account and a phone number registered through the Meta Business Manager .
+
+
Connecting WhatsApp
+
+
+
+
Get your credentials from Meta
+ In Meta for Developers → Your App → WhatsApp → API Setup:
+
+ Phone Number ID — the ID of your registered numberBusiness Account ID — your WABA IDPermanent Access Token — generate from System Users in Business Manager
+
+
+
+ Enter credentials in dashboard
+ Open SquareMCP dashboard → WhatsApp → Connect → paste all three values → Save.
+
+
+
+
+ Configure the webhook (optional — for inbound messages)
+ In Meta for Developers → Webhooks, set the callback URL to https://hermes.squaremcp.com/webhook/whatsapp and the verify token to your WA_VERIFY_TOKEN (ask support for this). Subscribe to the messages field.
+ Then configure a forwarding URL in SquareMCP dashboard → Webhooks so inbound messages reach your server.
+
+
+
+
+
Sending messages
+
Freeform message (within 24-hour session window)
+
Send a WhatsApp message to +447911123456 saying:
+"Hi! Your order #12345 has shipped and will arrive tomorrow."
+
+
Template message (anytime)
+
List my WhatsApp message templates
+
+Send the "order_confirmation" template to +447911123456
+with variables: order_id=12345, delivery_date="14 May 2026"
+
+
+ 24-hour rule
+ WhatsApp only allows freeform messages within 24 hours of a customer contacting you first. Outside that window, use approved template messages.
+
+
+
+
📷 Instagram
+
+
What you can do
+
+ Publish image posts and reels
+ View profile and recent media
+
+
+
Connecting Instagram
+
Instagram posting requires a Business or Creator account connected to a Facebook Page.
+
+
+
+
+
Get a Graph API access token
+ Open the
Graph API Explorer , select your app, and request
instagram_basic,
instagram_content_publish, and
pages_read_engagement permissions. Generate a User Access Token and exchange it for a long-lived token.
+
+
+
+ Find your Business Account ID
+ Call GET /me/accounts then GET /{page_id}?fields=instagram_business_account to find your Instagram Business Account ID.
+
+
+
+
+ Enter credentials in dashboard
+ SquareMCP dashboard → Instagram → Connect → paste the access token and Business Account ID.
+
+
+
+
+
Example prompts
+
Post an Instagram reel from https://cdn.example.com/reel.mp4
+with caption "Behind the scenes of our product shoot 🎬 #startup"
+
+Get my last 10 Instagram posts
+
+
+
+
+
Connecting Twitter / X
+
+
+
+
Create a developer app
+ Go to
developer.twitter.com and create a project and app. Enable
OAuth 1.0a with Read and Write permissions.
+
+
+
+ Generate all four credentials
+ In your app → Keys and tokens: copy the API Key , API Secret , Access Token , and Access Token Secret (all four are required).
+
+
+
+
+ Enter credentials in dashboard
+ SquareMCP dashboard → Twitter / X → Connect → paste all four values.
+
+
+
+
+
Example prompts
+
Tweet: "We just shipped our v2 release 🚀 Read the changelog at squaremcp.com"
+
+Upload the video at /tmp/demo.mp4 and tweet "Watch our new feature demo!"
+
+Search Twitter for tweets mentioning "SquareMCP"
+
+
+
✈️ Telegram
+
+
Connecting Telegram
+
+
+
+ Create a bot with BotFather
+ Open Telegram and message @BotFather. Send /newbot, choose a name and username, and copy the API token it provides (format: 123456789:ABCdef...).
+
+
+
+
+ Enter the token in dashboard
+ SquareMCP dashboard → Telegram → Connect → paste the bot token.
+
+
+
+
+ Add your bot to a chat or group
+ Bots can only send messages to chats they're a member of. Add your bot to the target chat, then use telegram_get_updates to find the chat ID.
+
+
+
+
+
Example prompts
+
Send a Telegram message to chat ID -1001234567890 saying "Daily report ready!"
+
+Get the latest Telegram messages in my channel
+