# Odicci MCP > Odicci connects your AI agent to a dedicated marketing orchestration server. It lets you manage interactive lead capture campaigns—quizzes, spin wheels, and polls—without touching a dashboard. You can run campaign analytics, search customer records by behavior, create new user profiles, and monitor segment performance using natural conversation alone. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** gamification, interactive-marketing, customer-engagement, lead-capture, campaign-management, quizzes ## Description **Odicci connects your AI agent directly to an entire marketing orchestration system. You manage lead capture, CRM data, and campaign analytics using nothing but natural conversation.** You'll use this server to run complex campaigns—think quizzes or spin wheels—and track the resulting customer behavior without ever logging into a dashboard. Your agent handles all that heavy lifting: it builds profiles, monitors segment growth, pulls performance metrics, and manages rewards distribution, all through simple chat commands. **System Overview and Setup** You can first run `check_odicci_status` to confirm the server's data flow is active. When you're ready to manage campaigns, you start by viewing what's running with `list_experiences`, which gives you an overview of every managed interactive campaign. If you need to spin up a whole new marketing experience—like setting up a quiz or wheel—you use `create_experience` to launch it. You can then get the full technical details and configuration info for any existing setup using `get_experience`, so you know exactly how that particular campaign is configured. **Campaign Performance & Analytics** To see if your campaigns are actually working, run `get_experience_stats`. This pulls performance metrics like total interactions or completion rates for any specific campaign. You can also list all available rewards and prizes using `list_rewards` to check the catalog and monitor distribution metadata, making sure your gamification rules stay solid. **Customer Data Control and Search** Managing customer data is where this thing really shines. Instead of digging through spreadsheets, you use natural language commands to handle profiles. You can list every single user in your system with `list_customers`. If you need a full rundown on one specific person, you pass over their ID and run `get_customer` to pull all their details. Need to find someone based on traits—like 'all users who finished the quiz last week'? You use `search_customers` for those targeted queries. When an agent finds a new lead or interaction that needs recording, you build them into your database instantly using `create_customer`. **Segmentation and Audience Management** This server lets you treat your entire user base like one smart database that talks back. You can view all defined groups by calling `list_segments` to see what audience segments exist. For deeper analysis, you use `get_segment` to retrieve the specifics and composition of any given segment. This tells you exactly who belongs in a group and how campaign activity affects those groupings. **Putting It All Together** You can combine these tools into single conversational workflows. You don't just list customers; you search for them by specific criteria, then use that data to create a new user profile record. You check the stats on an experience, and if it performs well, you track which segment growth resulted from it. It’s all about using your agent to orchestrate marketing actions—from initial campaign launch (`create_experience`) to final customer profiling and reward tracking (`list_rewards`, `get_customer`). You'll manage everything in one chat window. ## Tools ### check_odicci_status Verifies the server's current connection status. ### create_customer Creates a new customer record in your database. ### create_experience Sets up a new interactive marketing campaign (e.g., a quiz or wheel). ### get_customer Retrieves the full details for one specific customer ID. ### get_experience_stats Pulls performance metrics, like total interactions or completion rates, for a campaign. ### get_experience Gets detailed metadata and configuration info for an existing experience. ### get_segment Retrieves the details and composition of a specific audience segment. ### list_customers Lists all customers currently in your system. ### list_experiences Provides an overview list of all managed interactive campaigns. ### list_rewards Shows a catalog list of available rewards and prizes. ### list_segments Lists all defined audience segments in the system. ### search_customers Runs targeted searches against your customer base using specific criteria. ## Prompt Examples **Prompt:** ``` List all active interactive experiences in Odicci. ``` **Response:** ``` I've retrieved your experiences. You have 3 active campaigns including 'Summer Quiz' and 'Instant Win Wheel'. Which one would you like to see customer entries for? ``` **Prompt:** ``` Show me the engagement statistics for my Summer Giveaway experience. ``` **Response:** ``` Your Summer Giveaway experience (ID: exp_3421) has generated 2,847 total interactions over 14 days. Unique participants: 1,923. Completion rate: 68%. Email opt-ins collected: 1,308 (68% of participants). Top traffic source: Instagram Stories (42%), followed by email campaigns (31%) and website embed (27%). ``` **Prompt:** ``` Search for all customers who participated in experiences tagged with loyalty. ``` **Response:** ``` I found 456 customers who engaged with loyalty-tagged experiences. Top segment: "Repeat Buyers" with 203 customers (45%). Average interactions per customer: 3.2. Most active customer: Sarah Martinez with 12 completed experiences. 78% of these customers have opted in for email communications. ``` ## Capabilities ### Manage Campaigns List all interactive experiences, retrieve their configuration details, or check real-time performance statistics for any campaign. ### Control Customer Data Search for specific customers by criteria, list entire customer lists, or create and update individual profiles directly from the agent. ### Define Audience Segments View and retrieve details on defined audience segments and monitor how campaign performance affects segment growth. ### Oversee Rewards & Prizes List available rewards and monitor the distribution metadata to ensure gamification rules are being met. ### Check System Status Verify the connection status of the Odicci server to confirm data flow is active. ## Use Cases ### Auditing a Campaign's Health The marketing manager needs to know if the 'Summer Quiz' is underperforming. They ask their agent to run `get_experience_stats` for that specific quiz. The agent immediately returns metrics: 1,923 unique participants but only 68% completion rate. This tells the team they need to redesign the quiz flow before spending more ad spend. ### Updating a Lead Profile A new lead just participated in the 'Instant Win Wheel' and provided an email opt-in. Instead of manually updating a spreadsheet, the agent runs `get_customer` to pull their existing ID, then uses `create_customer` with the updated email data. The profile is current instantly. ### Finding High-Value Leads The sales team needs leads who are highly engaged and have purchased before. They ask the agent to run `search_customers` filtered by 'Repeat Buyer' status AND those found in the 'loyalty' segment. The agent returns a list of 203 qualified contacts, ready for outreach. ### Listing All Active Assets The development team needs to audit all live campaigns. They run `list_experiences`, which immediately shows the names and status metadata for every active campaign—from quizzes to polls—so they know exactly what's running in production. ## Benefits - Stop manually pulling reports. Use `get_experience_stats` to pull total interactions, unique participants, and completion rates in a single chat prompt. You get real-time performance data without leaving your agent interface. - Maintain clean customer records by using `create_customer` or `get_customer`. Your agent can create or update user profiles immediately after they complete an interactive campaign, ensuring high-fidelity CRM data. - Target campaigns better than ever. Run a segment check with `list_segments` and then use `search_customers` to pull only the leads who match specific behavior criteria (e.g., 'Repeat Buyers'). - Track user funnels automatically. You can list all active campaigns using `list_experiences`, allowing you to quickly see which marketing assets are running and when they expire. - Keep your whole system synchronized. The agent monitors rewards distribution via `list_rewards` and helps ensure that every campaign (like a quiz) has the correct prize metadata linked up. ## How It Works The bottom line is: Your AI acts as a dedicated marketing coordinator, running complex lookups and updates using Odicci's 12 endpoints, so you never have to switch apps. 1. Subscribe to the Odicci MCP Server and input your API key. 2. Tell your AI client what you need (e.g., 'Show me the stats for the Summer Quiz'). 3. The agent runs the necessary tool calls, fetching structured data that it then presents back to you in plain language. ## Frequently Asked Questions **How do I use the Odicci MCP Server to check campaign stats?** You tell your agent to run `get_experience_stats` and provide the experience ID. The agent returns detailed performance metrics, such as unique participants and completion rates. **Can I find a customer using the search_customers tool?** Yes. You use `search_customers` and specify the criteria you're looking for (e.g., 'Repeat Buyer in Segment X'). This lets you pull specific leads instantly. **How do I create an experience with Odicci MCP Server?** You call the `create_experience` tool, providing the necessary metadata and campaign type. The agent handles the backend setup for the new interactive asset. **What is the difference between list_customers and search_customers?** `list_customers` pulls a full directory of every record. You use `search_customers` when you need to narrow that down—for instance, only finding customers who lived in 'California' or bought a specific product. **Do I need to call list_segments before using get_segment?** It’s best practice. Use `list_segments` first to see all available segment names. Then, use that exact name when calling `get_segment` for the data you want. **How do I use the `check_odicci_status` tool to verify my connection?** It confirms your API key and active server status immediately. This simple check verifies that your credentials are valid before you run complex operations, saving time when troubleshooting failures. **Can I update a customer's profile using the `create_customer` tool?** Yes, you use this function to manage changes to existing records. You pass updated details—like a new email or segment membership—to keep your CRM data accurate and current. **What information does `list_rewards` provide about prize metadata?** It gives you a full inventory of all configured prizes. This list includes reward names, associated point values, and details on whether the reward requires manual distribution approval. **Can my AI automatically find the details for a specific experience by its ID?** Yes! Use the `get_experience` tool with the Experience ID. Your agent will respond with complete metadata for the campaign, including title, type, and current status in seconds. **How do I find my Odicci Secret API Key?** Log in to your Odicci account, navigate to **Settings** > **Access Management** > **API**, and you will find your unique secret token there. You may need admin privileges to see it. **Can I create a new customer via the AI?** Absolutely. Use the `create_customer` tool. Provide the customer name and other metadata, and the agent will add the record to your Odicci database immediately.