# Podium MCP

> Podium connects your local business communication, review tracking, and messaging into one AI agent workflow. Manage customer conversations, pull contact lists, send targeted reviews, and get organization metadata—all without leaving your chat client.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** reputation-management, online-reviews, webchat, local-business, lead-conversion

## Description

This agent connects your local business comms—the stuff happening right in Podium—directly to your AI client. You manage customer outreach and reputation tracking without ever leaving the chat window. It’s built for people who need to talk to data, not navigate dashboards.

**Managing Customer Conversations:**
It lets you handle every active message thread across multiple locations using `list_conversations`. When you're ready to reply, you can send a direct response with `send_message`, just gotta give it the location ID and what you wanna say. You never have to manually check messages again.

**Handling Reviews & Reputation:**
You can pull all of your business review history for specific sites using `list_reviews`. If someone's had a good time, you don’t need to write an email; the agent sends a review request automatically with `send_review_invitation`. This keeps your reputation front and center.

**Building and Maintaining Contact Records:**
It handles all your customer profiles. You can pull a full list of every contact managed by the organization using `list_contacts`, or you can get specific, deep metadata on one user with `get_contact_details`. Need to add someone new? Just call `create_contact` and it builds the profile right in Podium.

**Mapping Your Business Footprint:**
You're not just managing contacts; you're mapping out your whole operation. You can pull a list of every physical business location with `list_locations`. For specific operational details about any site, use `get_location_details`. To get the big picture—the overall company setup metadata—you’ve got `get_organization_info`. The agent also pulls profile data for whoever is using it right now with `get_current_user`.

**System Configuration and Tools:**
The agent keeps tabs on your system too. You can list all the API webhooks that are active or configured using `list_webhooks`, letting you see exactly what's running in the background. It’s a full-stack comms manager, giving you direct access to every tool Podium uses.

## Tools

### create_contact
Creates a new customer profile record in Podium.

### get_contact_details
Retrieves specific metadata for one existing customer contact.

### get_location_details
Fetches specific operational details for a single business location ID.

### get_current_user
Pulls the profile data of the person currently using the AI client.

### get_organization_info
Retrieves metadata about the overall company account setup.

### send_review_invitation
Automatically sends a review request to a specific customer or group.

### list_contacts
Pulls a list of all customer contacts managed by the organization.

### list_conversations
Lists message threads for a specific location ID to review history.

### list_locations
Retrieves all registered physical business locations linked to the account.

### list_reviews
Fetches a list of customer reviews for one or more specified locations.

### list_webhooks
Lists all API webhooks that are currently configured and active.

### send_message
Sends a message to a contact, requiring both the location ID and the message body text.

## Prompt Examples

**Prompt:** 
```
List all my business locations in Podium.
```

**Response:** 
```
I've retrieved your locations. You have 2 active environments: 'Downtown Office' (ID: loc_123) and 'Westside Branch'. Which one would you like to see reviews for?
```

**Prompt:** 
```
Show me all unread customer messages from today across all communication channels.
```

**Response:** 
```
34 unread messages today across your channels. SMS: 18 messages (12 new inquiries, 4 appointment confirmations, 2 review responses). Google Business: 8 messages (5 questions about hours/services, 3 quote requests). Facebook Messenger: 5 conversations. Web chat: 3 live requests. Average response time today: 12 minutes. 6 messages are flagged as urgent based on sentiment analysis, including a billing complaint from a VIP customer.
```

**Prompt:** 
```
Send a review request via text message to the 15 customers who completed service today.
```

**Response:** 
```
Review requests sent to 15 customers. Message: "Thanks for choosing us today! We'd love your feedback. Leave a review here: [review_link]". Delivery status: 14 delivered, 1 pending. Based on historical data, you can expect 5-6 reviews (38% response rate). Your current Google rating: 4.7 stars from 234 reviews. These review requests typically boost monthly review volume by 40%.
```

## Capabilities

### Manage all customer conversations
List active chat threads across various locations and send messages programmatically.

### Pull business review history
Fetch, monitor, and analyze customer reviews for specific locations.

### Send automated review requests
Trigger a review invitation to satisfied customers directly from the chat agent.

### Build and maintain contact records
Create new customer contacts or pull detailed profile metadata for existing users.

### Map out physical locations
List all business sites and retrieve the overall metadata for your organization.

## Use Cases

### Needing to follow up on a service visit.
A customer just finished their appointment. Instead of logging in and manually sending an email/SMS, the agent runs `send_review_invitation` using the customer's contact info. The request goes out, and you track the delivery status immediately.

### Investigating a complaint from last week.
A manager needs to check what was discussed with an upset client. They ask the agent to run `list_conversations` for that location ID. The AI pulls up the full message history, letting them respond accurately using `send_message`.

### Cleaning up outdated customer records.
The team realizes they have contacts from old campaigns. They use `list_contacts` to see who exists and then run `get_contact_details` on the top 10 accounts to verify if the data is still accurate before re-engaging.

### Preparing for a new market launch.
Before opening a second branch, an owner needs all the details. They run `list_locations` to see what's active, then use `get_location_details` on the proposed site ID to pull necessary operational metadata.

## Benefits

- Centralized Outreach: Instead of jumping between chat platforms and CRM dashboards, you can list conversations (list_conversations) and send messages (`send_message`) directly through the agent. It keeps all customer communication in one place.
- Instant Reputation Insights: You don't need to visit a review site manually. Use `list_reviews` or `send_review_invitation` to check current sentiment, pull historical data, and automatically ask for more feedback.
- Complete Customer View: The agent handles the complex workflow of gathering context. By combining `list_contacts` with `get_contact_details`, you build a full customer profile without leaving your chat interface.
- Operational Clarity: Keep track of where everything is happening. Use `list_locations` and `get_location_details` to ensure all communication efforts are correctly tied to the right physical site.
- Efficiency Boost: You can pull system metadata (like webhook status using `list_webhooks`) or organization data (`get_organization_info`) instantly, helping you debug workflows faster than ever before.

## How It Works

The bottom line is: you use natural language commands to trigger specific API calls that handle data retrieval or outbound messages for you.

1. Subscribe to this server on Vinkius Marketplace.
2. Enter your Podium Access Token into the environment settings from your developer dashboard.
3. Start by prompting your AI client. For example, 'List all my business locations' to initiate a workflow.

## Frequently Asked Questions

**How do I list my business locations using Podium MCP Server?**
You call the `list_locations` tool. This returns a list of all physical sites associated with your account, giving you the IDs needed for other actions.

**Can I send a message without knowing the location ID? (Podium MCP Server)**
No. The `send_message` tool requires both the contact's information and a valid Location ID to work correctly, so always run `list_locations` first.

**What is the difference between list_contacts and get_contact_details? (Podium MCP Server)**
`list_contacts` gives you an overview of every contact. You must use `get_contact_details` when you need specific, deep information—like their last interaction date or a specialized field.

**How do I automate review requests with Podium MCP Server?**
You run the `send_review_invitation` tool. This sends the request message on your behalf and provides status updates, letting you track delivery rates immediately in the chat.

**How do I use get_organization_info to verify my account setup?**
It immediately pulls your current organization's core details. Run this after connecting the access token; it confirms you have the necessary read/write scope for all organizational settings and metadata.

**What specific data points does list_conversations provide?**
It lists conversation threads tied to a location ID. The output gives you thread IDs, associated contacts, and timestamps, letting your agent track who talked to whom across different channels.

**How can I monitor system events using list_webhooks?**
This tool pulls a complete list of all configured webhooks. You verify the endpoint URL, trigger status, and last activity date, which lets your AI client know what external events Podium is monitoring.

**What happens if I use create_contact with an existing customer's details?**
The server handles duplicate entries gracefully. It returns a specific error code indicating the conflict instead of failing, so your agent can then fetch the correct record using get_contact_details.

**Can my AI automatically find the latest reviews for a specific business location?**
Yes! Use the `list_reviews` tool with the Location ID. Your agent will respond with the most recent customer reviews and their ratings in seconds.

**How do I find my Podium Location ID?**
Ask the AI agent to run the `list_locations` tool. It will retrieve all your business locations along with their unique IDs for you to use in other commands.

**Can I send an SMS invitation for a review via the AI?**
Absolutely. Use the `send_review_invitation` tool. Provide the customer details and the location ID, and the agent will trigger the invitation via Podium immediately.