Overview
The Obenan AI MCP Server lets AI assistants manage multi-location business data on the Obenan platform. Through natural conversation, users can search locations, update business information, analyze customer reviews, and access Emotion AI analytics—all without leaving their AI assistant.
The server implements the Model Context Protocol (MCP) with OAuth 2.0 authentication and Streamable HTTP transport.
Features
Location Management
Search, view, and update business locations. Manage names, addresses, contact details, business hours, special hours, categories, services, brands, attributes, and service areas.
Review Intelligence
Analyze customer reviews with AI-powered sentiment analysis. View top positive and most concerning reviews, and reply to reviews directly through conversation.
Emotion AI Analytics
Access Obenan's Emotion AI engine for deep analytics: topic analysis, keyword sentiment, platform comparisons, reputation scoring, rating breakdowns, and AI-generated action plans.
Google Business Insights
View Google Business Profile performance data including search impressions, discovery vs. direct searches, keyword performance, and interaction breakdowns.
Content Management
Update short and long descriptions, manage SEO keywords, create Google Business posts, and update menus—all through natural language.
Setup Instructions
Prerequisites
- An Obenan account with at least one business location
- An AI assistant that supports MCP servers or connectors (Claude, ChatGPT, Claude Code)
- Any Obenan subscription tier
Claude (claude.ai / Claude Desktop)
Add the Obenan connector from the Claude Integrations directory, or add it manually:
- Open Settings → Integrations (or MCP Servers in Claude Desktop)
- Click Add Integration and enter the server URL
- Complete the OAuth login at agent.obenan.ai
- Start chatting — Obenan tools are now available
Claude Code (CLI)
Add the server to your Claude Code configuration:
Verify It Works
After setup, test the connection by asking:
You should see a list of your Obenan business locations. If prompted to approve tool access, click Allow.
-
1
Open ChatGPT
Go to chat.openai.com and sign in to your account.
-
2
Enable Developer Mode
Before adding custom connectors, you need to enable Developer mode. This is a BETA feature that allows you to add unverified connectors.
Settings → Apps & Connectors → Advanced settings → Enable "Developer mode" toggleNote: When enabled, you'll see a message that memory is disabled. This is normal for custom connectors.
-
3
Navigate to Connector Settings
Go to the settings menu and find the connectors section:
Settings → Apps & Connectors -
4
Add Custom Connector
Click the "Add Custom Connector" or "New Connector" button to create a new MCP server connection.
-
5
Enter Connector Details
Fill in the following information in the connector form:
Obenan AIAI-powered marketing automation for local businesseshttps://mcp.obenan.ai/mcpSelect OAuth from the Authentication dropdown menu.
obenanobenanNote: While this field is marked as optional, please enter "obenan" for proper authentication.
You'll see a warning banner about custom MCP servers introducing risk. Check the box that says "I understand and want to continue" to proceed.
-
6
Save & Connect
Click Create to add the connector. This will redirect you to agent.obenan.ai for authentication. After you log in successfully, you'll be redirected back to ChatGPT and the connection will be established automatically. The system will then load all available tools.
-
7
Start Using the Connector
You're all set! The Obenan AI connector is now available in any ChatGPT conversation. Test it by asking: "Show me all my locations"
Authentication
The server uses OAuth 2.0 Authorization Code flow with PKCE (Proof Key for Code Exchange). This is a secure, industry-standard protocol that does not require a client secret.
How it works
- Your AI assistant initiates the OAuth flow and redirects you to agent.obenan.ai
- You log in with your Obenan credentials
- After approval, you are redirected back to the AI assistant with an authorization code
- The assistant exchanges the code for an access token using PKCE verification
- All subsequent API calls use this token — your credentials are never shared with the AI assistant
OAuth Discovery
The server publishes standard OAuth metadata at:
- /.well-known/oauth-authorization-server — RFC 8414
- /.well-known/oauth-protected-resource — RFC 9728
Available Tools
Location Management
| Tool | Description | Type |
|---|---|---|
| search_locations | Search locations by name, address, or keyword | Read |
| get_my_locations | List all locations in your account | Read |
| fetch | Fetch a location by canonical ID | Read |
| get_location | Get full details for a specific location by ID | Read |
| get_location_posts | View Google Business posts for a location | Read |
| get_location_discoverability_keywords | View SEO/discoverability keywords | Read |
| search | General-purpose search across all locations | Read |
| get_group_info | Get details about a specific location group | Read |
| search_categories | Search available business categories | Read |
| get_location_business_hours | View business hours for a location | Read |
| get_my_groups | List all location groups in your account | Read |
| get_location_attrs | View location attributes (amenities, features) | Read |
| get_menu | View a location's menu | Read |
Review Analysis
| Tool | Description | Type |
|---|---|---|
| analyze_location_reviews | Analyze recent reviews with sentiment and trends | Read |
| reply_to_location_review | Post a reply to a customer review | Write |
| get_location_most_concerning_reviews | Get the most critical recent reviews | Read |
| get_location_top_positive_reviews | Get the highest-rated recent reviews | Read |
Emotion AI Analytics
| Tool | Description | Type |
|---|---|---|
| emotion_ai_platforms | Compare performance across review platforms | Read |
| emotion_ai_action_plans | AI-generated recommendations to improve ratings | Read |
| emotion_ai_overview | High-level overview: impressions, rating trends, variance | Read |
| emotion_ai_ratings | Rating distribution and breakdown by location | Read |
| emotion_ai_reputation | Online reputation score and metrics | Read |
| emotion_ai_keywords | Keyword cloud with sentiment scoring | Read |
| emotion_ai_topics | Topic-level sentiment analysis of reviews | Read |
| emotion_ai_details | Detailed filtered analytics with drill-down | Read |
Google Business Insights
| Tool | Description | Type |
|---|---|---|
| google_insights | Google Business Profile performance overview | Read |
| google_keyword_insights | Top keywords driving profile discovery | Read |
| google_search_breakdown | Direct vs. discovery search breakdown | Read |
Update Tools
| Tool | Description | Type |
|---|---|---|
| set_location_labels | Set internal labels for organization | Write |
| set_location_business_hours | Set regular business hours | Write |
| set_location_special_hours | Set special/holiday hours | Write |
| set_location_contacts | Update contact information | Write |
| create_location_post | Create a new Google Business post | Write |
| set_categories | Set business categories for a location | Write |
| set_location_keywords | Replace all SEO keywords for a location | Write |
| set_location_opening_hours | Set opening hours (alternative format) | Write |
| set_location_attrs | Set location attributes (amenities, etc.) | Write |
| add_location_keywords | Add keywords to existing set | Write |
| remove_location_keywords | Remove specific keywords | Write |
| set_social_links | Update social media profile links | Write |
| set_location_service_area | Set the service area for a location | Write |
| update_menu | Update a location's menu | Write |
| set_location_long_description | Update the long business description | Write |
| set_location_details | Update general location details | Write |
| add_services_and_brands | Add services and brands to a location | Write |
| set_location_short_description | Update the short business description | Write |
Usage Examples
Once connected, you can interact with Obenan tools through natural conversation. Here are examples of what you can do:
Privacy & Security
Obenan takes the security and privacy of your business data seriously.
Data Handling
- All communication uses HTTPS/TLS encryption
- OAuth tokens are scoped to your account — the AI assistant never sees your password
- The server processes requests in real-time and does not store conversation data
- Business data is accessed on-demand from the Obenan API and not cached
What data is accessed
- Business location information (name, address, hours, descriptions)
- Customer reviews and ratings (from Google and other platforms synced by Obenan)
- Aggregated analytics from Emotion AI (no personally identifiable reviewer data)
- Google Business Profile performance metrics
Policies
Support
Need help getting started or have questions about the Obenan MCP Server?
- Contact Us: obenan.ai/contact-us
- Email: support@obenan.com
- Website: obenan.ai