mcp-server by PostIdentity - MCP Server

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)

Go to postidentity.com/settings
Open the "Developers" section
Click "Create Key"
Give it a name (e.g., "Windsurf MCP")
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

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

Authentication Errors

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

"Insufficient Credits" Error

Buy credits at postidentity.com/credits

How It Works

You provide your access token in the MCP config
Server authenticates using token on startup
Token is used for all API requests to PostIdentity
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.

Contributing

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

License

Made with ❤️ by the PostIdentity team

PostIdentity/mcp-server

PostIdentity MCP Server

Features

Demo

Two Deployment Options

🖥️ Local MCP Server (This Package)

☁️ HTTP MCP Server

Prerequisites (Local Server)

🚨 v2.0 Migration Notice

Quick Start

1. Get Your API Key (Recommended)

2. Configure Your MCP Client

Available Tools

1. list_identities

2. generate_post

3. get_credits

4. list_posts

5. get_referral_stats

6. list_marketplace_templates

7. create_identity

8. archive_identity

9. generate_thread

10. generate_reply

Usage Examples

List Your Identities

Generate a Post

Refine a Post

Check Credits

View Referral Stats

Generate a Thread from YouTube Transcript

Generate a Reply

Local Development

Security

Troubleshooting

Tools Not Appearing

Authentication Errors

"Insufficient Credits" Error

How It Works

Credits & Pricing

Refinement Features

Links

Contributing

License

1. `list_identities`

2. `generate_post`

3. `get_credits`

4. `list_posts`

5. `get_referral_stats`

6. `list_marketplace_templates`

7. `create_identity`

8. `archive_identity`

9. `generate_thread`

10. `generate_reply`