# Niftyimages — how to use (mcp.ai)

Connect your Niftyimages account and use 9 tools for marketing automation straight from your AI agent. Connect with your own API key. Allowing marketers to create dynamic and personalized content for your email campaigns.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_niftyimages?ms=1787291340000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `niftyimages_get_images_stats`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/niftyimages`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/niftyimages/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/niftyimages/get/images/stats` — Tool to get aggregated stats for all images. Use when you need to retrieve statistical data and performance metrics for all images in the account.
- `POST https://api.mcp.ai/api/niftyimages/get/widget/user/images` — Tool to list widget images for a specific user. Use when you need to retrieve all images associated with a particular user and widget combination.
  - body: { user: string, widget_key: string }
- `POST https://api.mcp.ai/api/niftyimages/get/widget/user/stats` — Tool to get aggregated stats for a specific user on a widget. Use when you need to retrieve performance metrics for a particular user's interaction with a widget.
  - body: { user: string, widget_key: string }
- `POST https://api.mcp.ai/api/niftyimages/list/images` — Tool to page through images in your NiftyImages account. Use when you need to retrieve a list of all available images.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/niftyimages/list/maps` — Tool to retrieve all maps in your NiftyImages account. Use when you need to view all available maps for geo-targeting or location-based email content.
- `POST https://api.mcp.ai/api/niftyimages/list/widget/images` — Tool to list widget images for a time frame. Use when you need to retrieve images generated by a specific widget within an optional date range.
  - body: { end_date?: string, start_date?: string, widget_key: string }
- `POST https://api.mcp.ai/api/niftyimages/list/widget/stats` — Tool to retrieve widget statistics for a specified time frame from NiftyImages. Use when you need to view performance metrics such as impressions and clicks for your widgets.
  - body: { endDate?: string, startDate?: string }
- `POST https://api.mcp.ai/api/niftyimages/list/widget/users` — Tool to list widget users for a specified time frame from NiftyImages. Use when you need to retrieve users who interacted with a specific widget during a date range.
  - body: { endDate?: string, startDate?: string, widgetKey: string }
- `POST https://api.mcp.ai/api/niftyimages/list/widgets` — Tool to list all widgets in your NiftyImages account. Use when you need to retrieve all available widgets.

## Example prompts
- "What can I do in Niftyimages?"
- "Show me a summary of my Niftyimages account"

## More
- Page: https://mcp.ai/niftyimages
- Agent spec (llms.txt): https://mcp.ai/niftyimages/llms.txt
- Postman collection: https://mcp.ai/niftyimages/postman.json