Schema | AIVA MCP Server

Describes the environment variables required to run the server.

Name	Required	Description	Default
`DEBUG`	No	Set DEBUG=aiva:* environment variable for verbose logging
`AIVA_API_KEY`	Yes	Your AIVA API key
`AIVA_API_URL`	No	Custom API URL (default: https://api.aiva.io)	https://api.aiva.io
`SHOPIFY_STORE`	No	Your Shopify store domain
`SHOPIFY_ACCESS_TOKEN`	No	Direct Shopify access (bypasses proxy)

Features and capabilities supported by this server

Capability	Details
`tools`	{}

Functions exposed to the LLM to take actions

Name	Description
aiva_get_customer	Get customer profile by ID or email. Returns customer details, RFM segment, health score, and subscription status.
aiva_search_customers	Search customers with filters. Supports filtering by segment, subscription status, tags, and more.
aiva_get_rfm_segments	Get RFM (Recency, Frequency, Monetary) segment breakdown with customer counts and trends.
aiva_get_churn_risk	Get customers at risk of churning, sorted by risk score.
aiva_get_subscription	Get subscription details by ID or customer.
aiva_list_subscriptions	List subscriptions with filters.
aiva_get_delivery_schedule	Get upcoming deliveries for a customer or all subscriptions.
aiva_subscription_actions	Perform actions on subscriptions: pause, resume, skip, swap products.
aiva_get_affiliate	Get affiliate details and stats.
aiva_list_affiliates	List affiliates with stats, sortable by performance.
aiva_get_referrals	Get referral history for an affiliate.
shopify_get_products	Search and list products from the connected Shopify store.
shopify_get_product	Get product details by ID or handle.
shopify_get_orders	List orders with filters.
shopify_get_customer	Get Shopify customer details.

Interactive templates invoked by user choice

Name	Description
No prompts

Contextual data attached and managed by the client

Name	Description
No resources

AIVA MCP Server