# Showpad MCP

> Showpad MCP gives your AI agent deep administrative access to sales collateral and user data. Use it to search assets by keyword, pull full user profiles, map organizational divisions, and list every content channel in your Showpad environment.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** sales-enablement, collateral-management, asset-metadata, sales-efficiency, content-distribution, b2b-sales

## Description

This server gives your AI agent deep admin access to your Showpad sales collateral and user data. You don't need to click through dashboards or open endless folders just to find what you need; you'll let your agent interrogate asset libraries and user hierarchies using natural conversation prompts.

**Searching and Retrieving Assets**

To search for specific content, call `search_assets`. It finds collateral across the entire platform using keywords or metadata, giving you matching asset IDs and quick summaries. If you know exactly what you're looking for, you can start with `list_assets` to get a list of basic metadata for every single piece of content available. For deep dives, use `get_asset_details`; this pulls all the underlying metadata and information tied to one specific asset ID.

**User Accounts and Organizational Mapping**

To audit user accounts, your agent first runs `list_users` to get a complete list of every registered user. You can then fetch full profile details for any individual account using `get_user_details`. To map out the company structure itself, call `list_divisions`, which returns all major organizational divisions in Showpad. The server also helps you categorize content by listing all classification tags available with `list_tags`.

**Content Distribution and Environment Details**

When tracking how collateral moves around, your agent can list every official publishing channel used to distribute sales materials using `list_channels`. These tools let you map out the entire content flow—from initial asset creation through all distribution points. Together, these functions ensure your AI client has a full view of who's in the system and where the content lives.

Your agent can perform multi-step tasks from one prompt. You can ask it to find all assets related to a specific product line, confirm which organizational division manages those assets, and then list every channel that collateral uses for distribution—all without you having to manually navigate through three different tabs.

## Tools

### get_asset_details
Retrieves all metadata for a single, specified content asset ID.

### get_user_details
Fetches the full profile and role details for one specific Showpad user account.

### list_assets
Returns a list of IDs and basic metadata for all content assets available in Showpad.

### list_channels
Lists every official publishing channel used to distribute collateral across the organization.

### list_divisions
Retrieves a list of all major organizational divisions within Showpad.

### list_tags
Lists every classification tag used to categorize and organize content assets.

### list_users
Provides a complete list of all user accounts registered in Showpad.

### search_assets
Searches for content collateral using keywords, returning matching asset IDs and summaries.

## Prompt Examples

**Prompt:** 
```
Find all resources mentioning 'Product Roadmap' and fetch details on the first one.
```

**Response:** 
```
Executing `search_assets` robustly with query 'Product Roadmap'. Unearthed 4 collateral objects. Sequentially executing `get_asset_details` passively on asset 0cd3f-9... Discovered a 12-page presentation tagged aggressively with internal permissions and managed exclusively under the executive division structure heavily.
```

**Prompt:** 
```
List users systematically and check to see how many sit under the 'EMEA Enterprise' division.
```

**Response:** 
```
Initiating deep retrieval invoking `list_users` sequentially cross-referenced strictly traversing boundaries mapped via `list_divisions`. Count indicates approximately 34 individual internal representations actively bound beneath the EMEA Enterprise namespace structural label directly without active restrictions explicitly.
```

**Prompt:** 
```
List content channels available actively within my organization boundaries.
```

**Response:** 
```
Initiating raw matrix extraction accessing `list_channels` passively exclusively. Extracted 5 heavily prominent publishing funnels spanning structurally from direct marketing hubs, explicitly targeted external reseller networks, and localized sales hubs uniformly distributing collateral without disruption natively efficiently systematically.
```

## Capabilities

### Search for specific collateral
The tool finds content assets across the entire platform using keywords or metadata.

### Retrieve detailed asset data
It pulls every piece of metadata and information available for a single, known asset ID.

### Audit user accounts and profiles
The server lists all users in the platform and fetches the full profile details for any individual user account.

### Map organizational structure
It lists all major divisions within Showpad, allowing you to map out your company's hierarchy.

### Track content distribution paths
The tool enumerates every publishing channel and category used for distributing sales collateral.

## Use Cases

### Checking compliance for a new product launch
A Content Strategist needs to know which collateral is available for 'Product X' and if it's tagged correctly. They run `search_assets` with 'Product X', then use `list_tags` to verify the required tags exist, finally using `get_asset_details` on a result ID to confirm all metadata fields are filled out.

### Auditing user access rights across regions
A Sales Ops Manager needs to know how many reps in EMEA have access to the executive pitch deck. They run `list_users` and then cross-reference with `list_divisions`, filtering for 'EMEA' first, before confirming permissions on key assets.

### Mapping out content governance
A Product Manager wants to see every way collateral can be distributed. They run `list_channels` and then use `list_tags` to understand what categories are available for tagging those channels, giving a full picture of the content lifecycle.

### Quickly finding a specific user's history
A manager needs to check a rep's current profile details. They run `list_users` to find the ID, then use `get_user_details` to pull all relevant information without opening the dashboard.

## Benefits

- Find collateral instantly. Instead of clicking through folders to find a brochure, just run `search_assets` with keywords (e.g., 'Q3 launch') and get the IDs immediately.
- Map your org structure without logging in. Running `list_users` followed by `list_divisions` lets you audit user hierarchies and see how many people belong to each division—all from one query.
- Deep dive on any asset. Once `search_assets` gives you an ID, use `get_asset_details` to pull every piece of underlying metadata; that's what you really need for reporting.
- Understand content flow paths. Use `list_channels` to see the entire spectrum of distribution points—from direct marketing hubs to external reseller networks.
- Cross-reference users and tags. You can list all users (`list_users`) and then check if their assigned division (using `list_divisions`) matches the asset tag they need access to.

## How It Works

The bottom line is: Instead of navigating Showpad's UI, your agent runs precise API calls to pull exactly the data you need.

1. Start by running a broad discovery query (e.g., `list_assets` or `list_users`) to get the initial list of IDs.
2. Use the returned ID(s) to narrow down the data point by calling a specific getter tool (like `get_asset_details`).
3. Your AI client compiles the structured output, giving you all the raw metadata and context needed for your task.

## Frequently Asked Questions

**How do I find out what tags are used on assets using list_tags?**
You run `list_tags` directly. This tool returns a master list of every available content classification tag in the system, allowing you to check if specific criteria were applied.

**I need details for one asset ID; should I use search_assets or get_asset_details?**
Use `get_asset_details` when you already have the exact Asset ID. If you don't know the ID, start with `search_assets` using keywords first.

**Can I list all users and their division simultaneously?**
You must run `list_users` to get the raw user data, and then separately call `list_divisions`. Your agent will help you cross-reference the two resulting lists.

**What is the difference between list_assets and search_assets?**
`list_assets` gives you a basic inventory of all content IDs. `search_assets` lets you filter that inventory using keywords, which is much more useful for finding specific collateral.

**When using `get_user_details`, what security best practices should I follow for my API access token?**
You must pass your Showpad API credentials as an environment variable, not hardcode them. Vinkius recommends storing the token in a dedicated secrets manager to prevent exposure and ensure secure runtime access.

**How can I use `list_divisions` combined with `search_assets` to restrict my search scope?**
You first invoke `list_divisions` to get the specific division ID. Then, you pass that ID as a mandatory filter parameter into `search_assets` so your results are scoped only to content within that corporate unit.

**If I run `list_channels` and it returns thousands of entries, does the MCP support pagination?**
Yes, the server supports chunked retrieval. If the result set exceeds a single API page limit, you must use the provided cursor or offset parameter in subsequent calls to ensure you gather every channel record.

**What specific types of metadata do I get when calling `get_asset_details`?**
The tool returns deep data points beyond simple descriptions. You receive the asset's full owner ID, creation date stamp, last modification timestamp, and a count of associated usage metrics.

**Can the integration alter, upload, or delete assets directly?**
By structural design, this module is strictly bound as an observational and auditing lens. Operations such as `search_assets`, `list_channels`, and `get_user_details` parse and extract massive contextual architecture. It explicitly omits write mechanisms preventing your autonomous agent from accidentally sabotaging or permanently deleting valid organizational sales assets.

**Why construct this manually over downloading platform-provided CSVs?**
Static extracts decay instantly upon creation implicitly blinding observers. The MCP parameter configuration hands your prompt active, unadulterated runtime authority to scan real-time hierarchies, pull active tags, and interrogate asset metadata aggressively instantly. It creates dynamic query dialogue natively routing structural truths.

**Are specific domain aliases required for the query logic?**
Yes exactly. Because Showpad physically partitions tenants distinctively, providing and solidifying the `SHOWPAD_SUBDOMAIN` variable string guarantees the underlying path execution targets explicitly your organizational API backbone (`your-subdomain.showpad.biz`) ruthlessly.