PostIdentity MCP Server

Official MCP server for PostIdentity - Generate AI-powered social media posts from any AI assistant that supports the Model Context Protocol (MCP).

Features

• 🎭 Manage Identities - List, create, and archive your writing personas
• ✍️ Generate Posts - Transform thoughts into posts instantly
• 🧵 Generate Threads - Turn long-form content into cohesive multi-post threads
• 💬 Generate Replies - Create authentic replies to other posts
• 🔄 Refine Posts - Regenerate, shorten, lengthen, or adjust style (1 credit per refinement)
• 📐 Character Limits - Generate posts for Twitter, LinkedIn, or custom lengths
• 📝 Review Posts - Browse your post history on specific identities
• 💳 Check Credits - Monitor your credit balance
• 🎁 Track Referrals - View your referral stats and code
• 🛍️ Browse Marketplace - Discover identity templates
• 🔒 Secure - Token-based authentication with RLS protection

Demo

Click to watch: See PostIdentity MCP in action

Two Deployment Options

🖥️ Local MCP Server (This Package)

For local AI assistants like Windsurf, Claude Desktop, and other MCP-compatible tools.

• Transport: stdio (stdin/stdout)
• Installation: npx @postidentity/mcp-server
• Best for: Desktop AI assistants

☁️ HTTP MCP Server

For cloud-based integrations like Gumloop and other HTTP-based MCP clients.

• Endpoint: https://izonnqmeqgzmuowhglfx.supabase.co/functions/v1/mcp
• Transport: HTTP with JSON-RPC 2.0
• Authentication: X-API-Key header
• Best for: Cloud platforms, custom integrations

Example usage:

curl -X POST https://izonnqmeqgzmuowhglfx.supabase.co/functions/v1/mcp \
  -H "X-API-Key: pi_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Both servers provide identical functionality and identical output - just different transport mechanisms.

---

Prerequisites (Local Server)

• Node.js 18+ (for local development)
• A PostIdentity account
• An MCP-compatible AI assistant (Windsurf, Claude Desktop, etc.)

🚨 v2.0 Migration Notice

If you're upgrading from v1.x: Access tokens still work, but we strongly recommend switching to API keys for permanent access. Access tokens expire hourly and require manual updates.

Quick Start

1. Get Your API Key (Recommended)

1. Go to postidentity.com/settings
2. Open the "Developers" section
3. Click "Create Key"
4. Give it a name (e.g., "Windsurf MCP")
5. Copy the key immediately - you won't see it again!

2. Configure Your MCP Client

Recommended (v2.0+):

{
  "mcpServers": {
    "postidentity": {
      "command": "npx",
      "args": [
        "-y",
        "@postidentity/mcp-server@latest",
        "--api-key",
        "your_api_key_here"
      ]
    }
  }
}

Legacy (still supported):

{
  "mcpServers": {
    "postidentity": {
      "command": "npx",
      "args": [
        "-y",
        "@postidentity/mcp-server@latest",
        "--access-token",
        "YOUR_ACCESS_TOKEN_HERE"
      ]
    }
  }
}

⚠️ Note: Access tokens expire every hour and need manual renewal. Use API keys for permanent access.

Available Tools

1. list_identities

Get your writing identities.

Parameters:

• status (optional): Filter by "active" (default), "archived", or "all"

Examples:

"Show me my PostIdentity identities"
"Show me my archived identities"
"Show me all my identities"

2. generate_post

Transform a thought into a post using an identity's style. Supports refinement options.

Parameters:

• identity_id (required): Identity UUID or name (e.g., "Tech Blogger")
• thought_content (required): Your thought/idea
• character_limit (optional): Max character count (e.g., 280 for Twitter/X)
• refinement_type (optional): "regenerate", "shorter", "longer", "style_adjust", or "refine"
• session_id (required for refinements): Random UUID for the refinement session
• previous_post (required for refinements): The post to refine
• style_adjustment (for "style_adjust"): "more_casual", "more_formal", "add_humor", "more_serious", "more_direct", "add_emojis"
• custom_feedback (for "refine"): Your specific feedback

Examples:

"Generate a post as Tech Blogger about AI trends"
"Generate a Twitter post (280 chars) as Tech Blogger about AI trends"

Cost: 1 credit per generation or refinement

3. get_credits

Check your current credit balance.

Example:

"How many PostIdentity credits do I have?"

4. list_posts

Browse your generated posts.

Parameters:

• profile_id (optional): Filter by identity UUID or name (e.g., "Tech Blogger")
• limit (optional): Number of posts (default: 10)

Examples:

"Show me my last 5 posts"
"Show me posts from Tech Blogger"

5. get_referral_stats

View your referral code and stats.

Example:

"What's my PostIdentity referral code?"

6. list_marketplace_templates

Browse identity templates in the marketplace.

Parameters:

• category (optional): Filter by business/creative/personal

Example:

"Show me business identity templates"

7. create_identity

Create a new identity from examples.

Parameters:

• name (required): Identity name
• description (required): Writing style description
• examples (required): Array of 3+ example posts (more = better accuracy)

Example:

"Create a tech blogger identity with these examples: ..."

8. archive_identity

Archive an identity (can be restored later).

Parameters:

• identity_id (required): Identity UUID or name to archive

Example:

"Archive my Tech Blogger identity"

9. generate_thread

Generate a cohesive thread (multiple connected posts) from one thought. Perfect for breaking down YouTube transcripts, articles, or complex ideas into a series of posts.

Parameters:

• identity_id (required): Identity UUID or name
• thought_content (required): Long-form content to transform (YouTube transcript, article, etc.)
• post_count (optional): Number of posts (3-10) or "auto" (default: "auto")
• platform (optional): "twitter" (280 chars) or "linkedin" (500 chars) - default: "twitter"
• character_limit (optional): Override character limit per post

Examples:

"Generate a Twitter thread as Tech Blogger about this YouTube transcript: [paste transcript]"
"Create a 5-post LinkedIn thread as Tech Blogger about AI trends"

Cost: 1 credit per thread (regardless of number of posts)

10. generate_reply

Generate a reply to an existing post in your identity's voice. Perfect for engaging with other users' content authentically.

Parameters:

• identity_id (required): Identity UUID or name
• original_post (required): The post you're replying to (full text)
• reply_direction (required): Your intended points/reaction
• character_limit (optional): Max characters (default: 280)

Examples:

"Generate a reply as Tech Blogger to this post: [paste post]. Agree with them but add nuance about AI safety."
"Reply as Tech Blogger: [original post]. Point out a flaw in their argument about productivity tools."

Cost: 1 credit per reply

Usage Examples

List Your Identities

You: "List my PostIdentity identities"
AI: "Found 2 identities:
     1. Tech Thought Leader
        ID: abc123...
     2. Casual Developer
        ID: def456..."

Generate a Post

You: "Generate a post as Tech Thought Leader about AI safety"
AI: "✅ Post generated successfully!
     
     AI safety isn't about preventing sci-fi scenarios.
     It's about ensuring predictable behavior TODAY.
     
     💳 Remaining credits: 45"

Refine a Post

You: "Make that post shorter" (with refinement parameters)
AI: "✅ Post generated successfully!
     
     AI safety is about predictable behavior TODAY,
     not sci-fi scenarios.
     
     💳 Remaining credits: 44"  (1 credit charged)

Check Credits

You: "How many credits do I have?"
AI: "💳 Current Balance: 45 credits
     ✅ You can generate 45 more posts"

View Referral Stats

You: "What's my referral code?"
AI: "🎁 Referral Stats
     📋 Your Code: ABC123XY
     👥 Total Referrals: 3
     💰 Credits Earned: 15"

Generate a Thread from YouTube Transcript

You: "Generate a Twitter thread as Tech Blogger about this YouTube transcript:
      [paste long transcript here]"
AI: "✅ Thread generated successfully!
     
     📝 5 posts in thread
     ──────────────────────────────────────────────────
     
     **Post 1/5** (276 chars)
     [Hook: Attention-grabbing opening]
     ──────────────────────────────
     
     **Post 2/5** (280 chars)
     [Development: Key point 1]
     ...
     
     **Post 5/5** (265 chars)
     [Conclusion: Strong takeaway]
     
     💳 Remaining credits: 44
     🆔 Thread ID: abc123..."

Generate a Reply

You: "Reply to this post as Tech Blogger: 'AI will replace all programmers by 2030'
      Disagree politely but firmly, emphasizing augmentation over replacement."
AI: "✅ Reply generated successfully!
     
     📩 **Original post:**
     AI will replace all programmers by 2030...
     
     💬 **Your reply:**
     ──────────────────────────────────────────────────
     Respectfully disagree. The last 20 years of 
     automation didn't replace programmers—it made 
     them 10x more productive. AI is a tool, not a 
     replacement. The best devs will be those who 
     master the tool.
     ──────────────────────────────────────────────────
     
     💳 Remaining credits: 43"

Local Development

# Clone the repository
git clone https://github.com/PostIdentity/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally
node dist/index.js --access-token YOUR_TOKEN

Security

✅ Token-based authentication - No passwords stored
✅ Row Level Security (RLS) - Database-level access control
✅ User isolation - Can only access your own data
✅ Credit system - Natural rate limiting
✅ Audit trail - All transactions logged

Troubleshooting

Tools Not Appearing

1. Verify JSON syntax in config file
2. Check token is correct and not expired
3. Restart your AI assistant completely
4. Check logs for errors

Authentication Errors

1. Get fresh token from postidentity.com/settings
2. Update your MCP config with new token
3. Restart AI assistant

"Insufficient Credits" Error

Buy credits at postidentity.com/credits

How It Works

1. You provide your access token in the MCP config
2. Server authenticates using token on startup
3. Token is used for all API requests to PostIdentity
4. All operations respect your credits and RLS policies

Credits & Pricing

• Free Trial: 5 credits on signup
• Generation: 1 credit per post
• Refinements: 1 credit per refinement
• Referrals: 5 credits per referral (for both users)
• Pricing: Starting at $5 for 15 credits

Buy credits →

Refinement Features

Refine your generated posts with these options:

• regenerate: Generate a completely new version
• shorter: Reduce length by ~40% while keeping the message
• longer: Add more detail and context
• style_adjust: Apply a single predefined tone change (more casual, formal, humor, etc.)
• refine: Apply any custom feedback, mixed instructions, or specific edits

How It Works: Your AI assistant automatically chooses the right refinement type based on your natural language request:

• "Make it shorter" → shorter
• "Add more humor" → style_adjust: add_humor
• "Make it more direct and remove em dashes" → refine (custom feedback for mixed instructions)
• "Try again" → regenerate

Note: In the MCP server, all refinements cost 1 credit. The web app at postidentity.com offers the first 3 refinements free per session.

Links

• 🌐 Web App: postidentity.com
• 📦 npm Package: @postidentity/mcp-server
• 🐛 Issues: GitHub Issues
• 📧 Support: support@postidentity.com

Contributing

Contributions are welcome! Please open an issue or submit a PR.

License

MIT © PostIdentity

---

Made with ❤️ by the PostIdentity team