Hrizn MCP

Hrizn MCP connects supported AI assistants to your dealership’s Hrizn account. Once connected, you can ask questions about inventory, content, IdeaClouds, reviews, local market activity, and more using natural language.

Hrizn MCP works with your dealership’s data. A documentation MCP connection can only search these help pages.

Get started

In Hrizn, open Dealership Manager → API & MCP.
Choose what you want your AI assistant to do:
- Look up data for questions and research
- Look up & create for content creation and compliance checks
- Add Market Maker or Social Hub posting when available on your plan
Create an API key.
Select your AI client and copy the provided setup.
Restart or reload the AI client, then ask a dealership-specific question.

API keys are shown once. Store them securely and never share them in a chat, document, or public repository.

What you can do

Understand your dealership

Summarize Dealer DNA, brand voice, staff, marketing priorities, and target geography
Find dealership links and other account details
Give outside agencies or approved partners useful dealership context

Work with inventory

Search by make, model, year, price, mileage, age, color, trim, stock number, or VIN
Review inventory mix, aging, and merchandising health
Find vehicles missing Hrizn AI descriptions
Retrieve details and descriptions for a specific vehicle

Plan and create content

Find existing articles and published pages
Review content opportunities and recommendations
Explore IdeaCloud topics and questions
Create IdeaClouds and turn selected ideas into content
Build model landing pages, comparisons, and sales event pages

Check OEM compliance

Review pasted ad, landing-page, or social copy
Identify higher-risk language and suggested replacements
Recheck copy after approved changes
Check existing Hrizn content

Compliance results are guidance based on automotive advertising rules. They are not legal advice.

Review connected social accounts, posts, and customer reviews
Draft and publish review replies
Create, schedule, update, or remove social posts
Add media through a secure upload link

If an account needs to be connected again, open Dealership Manager → Social Profiles in Hrizn.

Use Hrizn Market Maker

Review local listings and market days supply
Compare inventory pricing with the local market
Identify price-cut candidates and stocking opportunities
Appraise vehicles and review comparable listings
Explore vehicle options and packages

Market Maker and Social Hub publishing require an Unlimited plan.

Tool catalog

Available tools depend on the API-key preset, scopes, connected products, and plan.

Tool	Purpose
`analyze_inventory_pricing`	Compare dealer inventory pricing with resolved local-market segments.
`analyze_vehicle_position`	Position one dealer vehicle against market evidence.
`apply_compliance_fixes`	Apply confirmed OEM-compliance fixes.
`apply_recommended_selection`	Apply the recommended IdeaCloud selection.
`appraise_vehicle`	Benchmark a year/make/model with optional trim and mileage.
`check_compliance`	Check supplied copy for OEM-compliance risks.
`create_comparison`	Create a vehicle comparison.
`create_content`	Create content from an approved IdeaCloud selection.
`create_ideacloud`	Start an IdeaCloud research workflow.
`create_model_landing`	Create a model landing page.
`create_sales_event`	Create a sales-event page.
`delete_social_post`	Delete a confirmed social post.
`finalize_social_post`	Finalize a prepared social post after confirmation.
`find_content_to_cite`	Find published Hrizn content with live URLs.
`find_ideaclouds`	Search dealership IdeaClouds.
`find_reviews`	Find customer reviews using public-reply status.
`find_vehicles`	Search dealership inventory.
`generate_review_reply`	Draft a customer-review reply.
`get_competitive_set`	Retrieve a resolved local competitive set.
`get_content`	Retrieve one content item.
`get_content_compliance`	Retrieve content compliance results.
`get_content_opportunities`	Retrieve prioritized content opportunities.
`get_content_recommendation`	Retrieve one content recommendation.
`get_dealer_context`	Retrieve public-safe dealership context.
`get_ideacloud`	Retrieve an IdeaCloud.
`get_ideacloud_cluster`	Retrieve an IdeaCloud cluster.
`get_ideacloud_outline`	Retrieve an IdeaCloud outline.
`get_ideacloud_selection`	Retrieve the current IdeaCloud selection.
`get_inventory_health`	Retrieve current-lot aging and merchandising health.
`get_inventory_stats`	Retrieve inventory mix and aggregate statistics.
`get_local_market_listings`	Retrieve resolved local-market listings.
`get_market_days_supply`	Retrieve market days supply for a resolved segment.
`get_market_price_analysis`	Retrieve market-price evidence for a vehicle.
`get_price_cut_candidates`	Find bounded aged, over-market price-cut candidates.
`get_review`	Retrieve one customer review.
`get_social_post`	Retrieve one social post.
`get_social_presence`	Retrieve connected social-presence context.
`get_stocking_opportunities`	Find bounded stocking opportunities.
`get_vehicle`	Retrieve one inventory vehicle.
`get_vehicle_options_packages`	Retrieve available VIN options and packages.
`list_content`	List dealership content.
`list_ideacloud_suggestions`	List IdeaCloud suggestions.
`list_layouts`	List available content layouts.
`list_social_posts`	List social posts.
`list_vehicle_makes`	List canonical vehicle makes.
`list_vehicle_models`	List canonical vehicle models.
`list_vehicle_trims`	List canonical vehicle trims.
`list_vehicle_years`	List canonical vehicle years.
`prepare_social_post`	Prepare a social post and confirmation preview.
`publish_review_reply`	Publish a confirmed review reply.
`retry_social_post`	Retry actionable failed social-post targets.
`set_ideacloud_selection`	Set a confirmed IdeaCloud selection.
`trigger_content_compliance`	Start compliance review for existing content.
`unpublish_social_post`	Unpublish one resolved social target.
`update_ideacloud_settings`	Update IdeaCloud settings.
`update_social_post`	Update a confirmed social post.
`wait_for_content`	Wait for content generation to reach a terminal state.
`wait_for_content_compliance`	Wait for compliance review completion.
`wait_for_ideacloud`	Wait for IdeaCloud research completion.
`wait_for_media_session`	Wait for prepared social media processing.
`wait_for_social_post`	Wait for a social post to reach a terminal state.

For find_vehicles, total_count remains the raw matching inventory aggregate for backward compatibility. It can include malformed source rows omitted from the returned vehicles. Use raw_total_count, invalid_row_count, and total_count_includes_invalid_rows to interpret data quality without assuming every counted source row is retrievable. invalid_row_count reports malformed rows encountered during the bounded raw-page scan; it is not a whole-lot count unless the scan reached the end.

IdeaCloud text-first curation checklist

Before creating content, review the IdeaCloud outline, cluster, and current selection. Apply a recommended or explicit selection only when the assistant presents the proposed change and you confirm it.

Connect manually

The easiest setup is the client-specific configuration in Dealership Manager → API & MCP. If you need to configure a client manually, use:

https://api.app.hrizn.io/v1/public/mcp?profile=read

The read profile is the safest starting point. Use another profile only when the key has the matching scopes and the assistant needs those tools.

Cursor or Claude Code

Add this to .cursor/mcp.json or your Claude Code MCP settings:

{
  "mcpServers": {
    "hrizn": {
      "url": "https://api.app.hrizn.io/v1/public/mcp",
      "headers": {
        "X-API-Key": "${env:HRIZN_API_KEY}"
      }
    }
  }
}

Set HRIZN_API_KEY to the key you created before launching the client.

OpenCode

Add the Hrizn MCP URL with ?profile=read to your OpenCode MCP configuration and send the API key in the X-API-Key header. Keep the key in an environment variable rather than committing it.

Amazon Q / Kiro

Add an HTTP MCP server using https://api.app.hrizn.io/v1/public/mcp?profile=read and map X-API-Key to your HRIZN_API_KEY environment variable.

OpenAI Codex

Add this to ~/.codex/config.toml:

[mcp_servers.hrizn]
url = "https://api.app.hrizn.io/v1/public/mcp"

[mcp_servers.hrizn.env_http_headers]
X-API-Key = "HRIZN_API_KEY"

Gemini CLI

Add this to ~/.gemini/settings.json:

{
  "mcpServers": {
    "hrizn": {
      "httpUrl": "https://api.app.hrizn.io/v1/public/mcp",
      "headers": {
        "X-API-Key": "${env:HRIZN_API_KEY}"
      }
    }
  }
}

For other supported clients—including Claude Desktop, VS Code, Windsurf, OpenCode, Continue, Cline, Zed, JetBrains, and Amazon Q/Kiro—copy the ready-to-use configuration from Hrizn.

Try these prompts

“Who are the sales managers at this store?”
“Summarize this dealership’s brand voice and DNA.”
“What used inventory is aged 60+ days?”
“Which units are missing a Hrizn AI description?”
“Show me the AI write-up for VIN …”
“What IdeaClouds do we have on Camry?”
“Top content opportunities this week?”
“Unanswered Google reviews under 3 stars?”
“Which published articles can I cite with a live URL?”
“Give me a lot health snapshot — aging and merchandising gaps.”
“Are my used RAV4s overpriced vs the local market?”
“What’s market days supply for new Camrys near us?”
“Which aged units should I cut price on first?”
“Create a model landing page for the 2026 Honda Civic Sport.”
“Compare these two vehicles and highlight why a shopper might choose each one.”
“Check this ad copy for OEM compliance.”
“Schedule a Facebook post for Saturday at 10:00 AM.”
“Draft a reply to our latest unanswered one-star review.”

Before making changes

Hrizn asks for confirmation before an AI assistant creates, publishes, updates, or removes anything. Review the proposed action carefully before approving it. Creating content through MCP can also update the same IdeaCloud and content workflows you use inside Hrizn.

Security

Treat API keys like passwords.
Start with Look up data unless the assistant needs to create or publish.
Create separate keys for different people or integrations.
Revoke keys you no longer use from Dealership Manager → API & MCP.
Do not share media upload links.

Troubleshooting

The connection is unauthorized: Create a new key and replace the old key in your client configuration.
A capability is unavailable: Check the selected key preset and your Hrizn plan.
A social account needs attention: Reconnect it in Dealership Manager → Social Profiles.
A media upload link expired: Ask the assistant to start a new upload.
The assistant can only search documentation: Connect Hrizn MCP from Dealership Manager → API & MCP.
New tools do not appear: Restart the AI client after updating its configuration.

Getting Started

Concepts

Guides

Scopes

Get started

What you can do

Understand your dealership

Work with inventory

Plan and create content

Check OEM compliance

Use Hrizn Market Maker

Tool catalog

IdeaCloud text-first curation checklist

Connect manually

Cursor or Claude Code

OpenCode

Amazon Q / Kiro

OpenAI Codex

Gemini CLI

Try these prompts

Before making changes

Security

Troubleshooting

​Get started

​What you can do

​Understand your dealership

​Work with inventory

​Plan and create content

​Check OEM compliance

​Manage social activity

​Use Hrizn Market Maker

​Tool catalog

​IdeaCloud text-first curation checklist

​Connect manually

​Cursor or Claude Code

​OpenCode

​Amazon Q / Kiro

​OpenAI Codex

​Gemini CLI

​Try these prompts

​Before making changes

​Security

​Troubleshooting

​Related

Get started

What you can do

Understand your dealership

Work with inventory

Plan and create content

Check OEM compliance

Manage social activity

Use Hrizn Market Maker

Tool catalog

IdeaCloud text-first curation checklist

Connect manually

Cursor or Claude Code

OpenCode

Amazon Q / Kiro

OpenAI Codex

Gemini CLI

Try these prompts

Before making changes

Security

Troubleshooting

Related