# Postproxy MCP

> Postproxy lets your AI client manage all your social media and local SEO content from one place. You can create, schedule, or delete posts across multiple platforms; read comments, reply to them using `createCommentReply`, or hide specific reviews and messages—all without logging into a dozen dashboards.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** social-publishing, local-seo, review-management, content-scheduling, multi-platform-management

## Description

Postproxy lets your AI client manage all your social media and local SEO content from one place. You won't have to jump between a dozen dashboards just to keep up with posting or handling comments.

**Listing Accounts & Groups**
You can check out every connected profile—`listProfiles` retrieves a complete list of individual accounts ready for publishing, and `listProfileGroups` shows all the predefined groups you set up for bulk management. This lets your agent know exactly what platforms are hooked up and where to publish.

**Creating & Managing Posts**
You can draft and push new content with `createPost`, specifying both the text and the desired status across multiple profiles in a single command. If you need to read older stuff, `listPosts` pulls up a full list of recent or published posts for auditing purposes. Need to check out one specific piece? Use `getPost` by its unique ID to pull all its details. Should content get old or inaccurate, you can wipe it clean using `deletePost`, removing the post entirely from the connected platform.

**Handling Comments and Reviews**
The system handles user interactions directly. You use `listComments` to fetch every comment associated with a post's ID so your agent has the full conversation history. Once you see something, you can act on it: `likeComment` registers a 'like' or reaction to any specific comment left on a post, and if someone said something important, you send a direct reply using `createCommentReply`. If the feedback is totally trash, you can change its public view status with `hideComment`, keeping your feed clean. But hey, what if you marked something wrong? You use `unhideComment` to restore that comment's public visibility.

**Putting It Together**
The whole workflow lets your agent read all the comments, then reply to specific ones, while simultaneously publishing a new post and making sure it hits every connected profile. This means you keep everything centralized—from listing available accounts to deleting old content outright.

## Tools

### createCommentReply
Sends a direct reply to a specific comment on a post using the API.

### createPost
Creates and publishes new content, allowing you to specify text, status, and target profiles.

### deletePost
Removes an existing post from the connected social media platform entirely.

### getPost
Retrieves the full details of one specific post by providing its unique ID.

### hideComment
Changes a comment's visibility status to hide it from public view on a post.

### likeComment
Registers a 'like' or reaction to a specific comment left on a post.

### listComments
Fetches all comments associated with a given post ID so you can review the conversation history.

### listPosts
Retrieves a list of recent or published posts across connected profiles for auditing purposes.

### listProfileGroups
Lists all the predefined groups you've set up to manage your social media accounts in bulk.

### listProfiles
Retrieves a complete list of every individual, connected social media profile available for publishing.

### unhideComment
Restores the public visibility of a comment that was previously hidden using `hideComment`.

## Prompt Examples

**Prompt:** 
```
List all my available social media profiles.
```

**Response:** 
```
I have fetched your available social profiles from Postproxy. You currently have a Twitter and a LinkedIn account connected.
```

**Prompt:** 
```
Schedule a new post for tomorrow morning announcing our new AI feature.
```

**Response:** 
```
Your post has been successfully scheduled. It is set to be published tomorrow across your selected profiles.
```

**Prompt:** 
```
Fetch the latest comments on my recent post.
```

**Response:** 
```
Here are the latest comments from your recent post. Let me know if you would like me to reply or hide any of them.
```

## Capabilities

### List available social media accounts
Retrieves a list of every connected profile and group, letting you know what platforms are ready for publishing.

### Create and schedule new posts
Publishes content to one or more linked profiles using provided text and status flags in a single call.

### Manage post visibility and deletion
Retrieves a specific post by ID, deletes old content outright (`deletePost`), or reads the full list of published posts via `listPosts`.

### Handle user comments and reviews
Reads all comments on a post using `listComments`, allowing you to then reply, like, or hide specific interactions.

### Control content access status
Hides inappropriate comments (`hideComment`) when necessary, and later restores them using `unhideComment` if they were wrongly flagged.

## Use Cases

### The Brand Reputation Crisis
A competitor starts leaving negative reviews on your Google Business Profile. You ask your agent to 'Check the latest activity.' The agent runs `listComments` and identifies three bad posts. You tell it to hide two of them using `hideComment`, then draft a public response using `createCommentReply`. Damage contained.

### The Multi-Location Campaign
You're launching a sale across 12 store locations. Instead of logging in 12 times, you tell your agent to 'Schedule the sale announcement.' The agent uses `listProfileGroups` to select all location profiles and runs `createPost`, deploying the message everywhere simultaneously.

### Content Cleanup
You need to remove an old promotion that was posted last month. You ask your agent to 'Find and delete the October sale post.' The agent uses `listPosts` to find the correct ID, then runs `deletePost`, keeping your feed clean.

### The Profile Audit
Before a major launch, you need to know if all channels are ready. You ask your agent to 'List all active social profiles.' The agent uses `listProfiles` and reports back on every single account status so the team can confirm readiness.

## Benefits

- Stop copying content. Using `createPost` lets your agent deploy the same message to five different platforms in a single instruction, guaranteeing consistency across all channels.
- Control reputation instantly. If you spot harassment, use `listComments` to review the thread, then use `hideComment` or `deletePost` to mitigate damage immediately, without manual intervention.
- Track everything easily. Need to know what was posted last week? Running `listPosts` gives you a clean audit trail of all content published across your network.
- Handle engagement at scale. Instead of responding manually, ask your agent to run through the latest comments and reply using `createCommentReply` for quick crisis management.
- Maintain profile sync. You can use `listProfiles` to confirm every single location or account is connected before launching a major campaign, preventing missed posts.

## How It Works

The bottom line is that your agent handles all the cross-platform API calls, so you just talk to it.

1. Connect your Postproxy account and provide the secure API token to your agent.
2. Instruct your AI client on the desired action (e.g., 'List all profiles' or 'Schedule a post').
3. The agent executes the required tool, passing necessary parameters like content text, target profile IDs, and status.

## Frequently Asked Questions

**How do I see all my connected social media profiles with Postproxy?**
Run the `listProfiles` tool. This pulls a complete list of every individual account linked to your Postproxy dashboard, ensuring you know exactly what channels are available for posting.

**Can I schedule posts across multiple locations using createPost?**
Yes. First, use `listProfileGroups` to select the relevant location group IDs. Then, your agent uses these IDs when calling `createPost` to deploy content everywhere at once.

**What's the difference between listPosts and getPost?**
`listPosts` gives you an overview—a summary of recent posts across all channels. Use `getPost` when you know the exact post ID and need to retrieve the full, specific details for review or modification.

**If I hide a comment using hideComment, how do I make it visible again?**
You must use the `unhideComment` tool. This restores public visibility to the comment on its original post, which is useful if you realize the comment was flagged in error.

**What happens if I use the createPost tool and the post fails to publish?**
The system returns an error code in the payload. You read the detailed message; it tells you exactly why the publication failed—maybe a profile ID is wrong, or the text contains forbidden characters. This helps pinpoint the failure immediately.

**How does Postproxy handle rate limits when I use listComments repeatedly?**
It handles throttling automatically. If your agent client hits an API limit while calling listComments, the tool pauses and retries later without crashing the workflow. You don't have to write complex retry logic yourself.

**When I use the listProfiles tool, what level of data access does my AI client get?**
Your agent only gets read-only scope for basic profile metadata by default. If you need it to perform actions like liking comments, you must explicitly grant write permissions within the Postproxy setup.

**How can I use getPost to verify if a post was deleted or just unpublished?**
The output payload includes a specific status field. You check this field for 'Deleted,' 'Published,' or 'Scheduled' confirmation, which tells you the true state of the content, not just its existence.

**Can the AI Agent schedule posts for any future date?**
Yes, as long as you provide a valid ISO date, your AI Agent can schedule posts using Postproxy.

**Can I manage comments directly from the AI Agent?**
Absolutely. You can list, like, reply, hide, or unhide comments across your posts seamlessly.

**Does the AI Agent support grouping profiles?**
Yes! The AI Agent can retrieve your Profile Groups so you can target multiple social media accounts at once.