Hrizn MCP

Hrizn MCP is our hosted Model Context Protocol server. After you save a rooftop grant and connect with OAuth, your assistant works against the same store you manage in Hrizn — inventory, dealer context, IdeaCloud research, published content, OEM compliance checking, Social Hub, and Market Maker — instead of guessing from the open web. Transport: Streamable HTTP with OAuth at:

https://mcp.app.hrizn.io/mcp

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

Get started (OAuth)

Sign in to Hrizn at app.hrizn.io.
Open MCP in the left navigation (not Dealership Manager).
Select at least one dealership rooftop and save your grant. OAuth without a saved grant returns mcp_grant_required.
Copy the endpoint if you need it for a CLI, or follow the in-app walkthrough for Claude, Cursor, Codex/ChatGPT, or Gemini.
Complete Hrizn sign-in when your AI client prompts, then ask a dealership-specific question to confirm tools are available.

On the MCP page, Learn about MCP tools opens a guide for each tool and how to use it with an agent. Plan requirements: granted rooftops need Teams or higher with API Access. Market Maker tools require Unlimited on the grant. Social Hub posting and review replies require Unlimited with write scopes.

Claude Desktop

Complete the grant steps above on app.hrizn.io first.
Follow the Claude walkthrough on the MCP page: Settings → Customize → Connectors → Add custom connector.
Name it Hrizn, paste https://mcp.app.hrizn.io/mcp, leave OAuth Client ID and Client Secret blank, then Connect and finish OAuth.
Under Tool permissions, keep write and delete tools on Needs approval unless you want them always allowed.

Claude.ai can use the same URL as a custom connector (or the Connectors Directory listing when available).

Claude Code

Install the public plugin, then authenticate:

/plugin marketplace add Horizn-Cloud/hrizn-claude-plugin
/plugin install hrizn@hrizn

Source: github.com/Horizn-Cloud/hrizn-claude-plugin. Claude Code uses OAuth (CIMD when supported). Do not paste hzk_ API keys for new connections.

OpenAI ChatGPT / Codex

Complete the grant steps on app.hrizn.io first.
In Codex or ChatGPT desktop: Settings → Integrations → Plugins → MCPs → Add MCP server.
Name it Hrizn, set type to Streamable HTTP, paste https://mcp.app.hrizn.io/mcp exactly (no trailing slash — Codex derives its OAuth client identity from this URL), leave headers empty, Save.
Turn the server on and click Authenticate. Sign in with your Hrizn account.

CLI equivalent:

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

Or let the CLI write it for you:

codex mcp add hrizn --url https://mcp.app.hrizn.io/mcp

codex mcp login hrizn

Codex is text-only: results arrive as compact JSON plus a guidance block (next_steps, links, job); the interactive cards described below appear in ChatGPT, not in the Codex CLI. Then run codex mcp login hrizn (or the Codex binary bundled in ChatGPT.app). If the browser lands on http://127.0.0.1:<port>/callback/... and the site cannot be reached, the desktop listener closed before Auth0 redirected — run codex mcp login hrizn again and finish OAuth in that session.

Cursor

Install from Cursor Directory (or the Hrizn Cursor plugin), complete OAuth when Cursor prompts, and keep your dealership grant saved on the MCP page. Walkthrough screens for Cursor in the Hrizn app are still being added. Until then, copy the Streamable HTTP with OAuth endpoint from the MCP page.

Google Antigravity

Install the public Hrizn Antigravity plugin:

git clone https://github.com/Horizn-Cloud/hrizn-antigravity-plugin.git
agy plugin install ./hrizn-antigravity-plugin

You can also copy the plugin folder to ~/.gemini/config/plugins/hrizn/ for all workspaces or .agents/plugins/hrizn/ for one workspace. The plugin uses this remote MCP configuration:

{
  "mcpServers": {
    "hrizn": {
      "serverUrl": "https://mcp.app.hrizn.io/mcp"
    }
  }
}

Do not add placeholder OAuth credentials. Antigravity uses Hrizn’s Dynamic Client Registration flow. Open Settings → Customizations → Installed MCP Servers, click Authenticate for Hrizn, then complete browser sign-in and submit the authorization code.

Other supported clients

VS Code, Windsurf, OpenCode, Continue, Cline, Zed, JetBrains, and Amazon Q/Kiro can connect to the same Streamable HTTP OAuth URL. Copy https://mcp.app.hrizn.io/mcp from the MCP page — we do not ship per-client config snippets.

The legacy API-key URL (api.app.hrizn.io/v1/public/mcp) remains for existing integrations. New connections should use OAuth at mcp.app.hrizn.io.

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

Work with search and traffic

Review warehoused Search Console and GA4 (requires analytics:read and Teams+ with API Access)
Notice movers with get_search_snapshot / get_search_alerts, then diagnose a URL with get_page_performance (the only live inspect)
Package gaps with get_create_brief, then create_ideacloud or create_content
Existing API keys must add analytics:read; see the analytics guide

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
Accept fixes on stored articles — the suggested wording is saved into the article
Dismiss findings with a reason, recorded in Hrizn so they stay resolved across re-checks

Every finding carries a stable id. For stored content the assistant acts through apply_content_compliance_fixes (issue_ids to fix, ignore_issue_ids to dismiss) — decisions persist with the article and appear in Composer. apply_compliance_fixes is the freeform variant for pasted copy: it returns revised text and stores nothing. 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 your saved grant, plan entitlements, and connected products. OAuth exposes the full entitled catalog; legacy API-key clients can narrow discovery with ?profile=read|create|market|social|full.

Tool	Purpose
`analyze_inventory_pricing`	Compare dealer inventory pricing with trim- and year-matched local market segments.
`analyze_vehicle_position`	Position one dealer vehicle within its comparable listings, active and recently sold.
`apply_compliance_fixes`	Return revised copy with confirmed OEM-compliance fixes applied (nothing is stored).
`apply_content_compliance_fixes`	Fix or dismiss compliance findings on stored content and save the result.
`apply_recommended_selection`	Replace the IdeaCloud basket with the recommended selection.
`appraise_vehicle`	Benchmark a year/make/model with optional trim and mileage.
`check_compliance`	Check supplied copy for OEM-compliance risks.
`compare_trims`	Compare trims of one model side by side.
`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 record (unpublish first while live).
`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_image`	Generate an AI image into the dealership’s Media Library (async).
`generate_review_reply`	Draft a customer-review reply.
`generate_vehicle_description`	Generate the Hrizn AI description for a stocked VIN.
`get_competitive_set`	Group live local listings by competing dealer (not your configured competitor list).
`get_content`	Retrieve one content item.
`get_content_compliance`	Retrieve content compliance results.
`get_content_decay`	Pages whose search clicks fell across three 30-day windows.
`get_content_opportunities`	Retrieve prioritized content opportunities.
`get_content_recommendation`	Retrieve one content recommendation.
`get_create_brief`	Create-brief: opportunities, gaps, decay, cannibalization, image VDP, and model vs inventory.
`get_dealer_briefing`	Snapshot how the dealership is doing right now.
`get_dealer_context`	Retrieve the ids and settings other tools consume.
`get_hrizn_playbook`	Read how Hrizn builds and evaluates its own work.
`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_image`	Read one Media Library image — url, alt text, AI metadata, prompt, disclaimer, article, and social variants.
`get_inventory_health`	Retrieve current-lot aging and merchandising health.
`get_inventory_stats`	Retrieve inventory mix and aggregate statistics.
`get_job`	Check one async job (status, progress, app link, result).
`get_local_market_listings`	Retrieve resolved local-market listings.
`get_market_days_supply`	Retrieve market days supply for a resolved segment, banded on one shared scale.
`get_market_price_analysis`	Retrieve market-price evidence for a vehicle.
`get_my_jobs`	List async jobs the grant started, pending and recently completed.
`get_page_performance`	Diagnose one URL: warehouse query×page plus live URL Inspection (24h cache).
`get_price_cut_candidates`	Find aged units genuinely placed over their trim-level comparable market.
`get_review`	Retrieve one customer review.
`get_search_alerts`	Click drops, gains, impression drops, and decaying pages for briefing.
`get_search_changes`	Period-over-period click and impression movers.
`get_search_gaps`	Search queries with demand and no dedicated Search Console landing page (and no matching Hrizn article).
`get_search_opportunities`	Queries with impression volume and CTR gap versus expected.
`get_search_questions`	Interrogative, near-me, and gen-AI exhaust query strings from Search Console.
`get_search_snapshot`	Warehoused Google Search Console snapshot for the lookback window.
`get_social_post`	Retrieve one social post.
`get_social_presence`	Retrieve connected social-presence context.
`get_stocking_opportunities`	Find bounded stocking opportunities.
`get_traffic_snapshot`	GA4 traffic snapshot from the warehouse.
`get_vehicle`	Retrieve one inventory vehicle.
`get_vehicle_demand_insights`	Fuse inventory, search, and GA4 demand by model.
`get_vehicle_options_packages`	Retrieve available VIN options and packages.
`get_vehicle_safety`	Check open safety recalls on a stocked VIN.
`list_connected_sites`	List OAuth-granted dealerships and per-site capability flags.
`list_content`	List dealership content by generation status (use `find_content_to_cite` for published pages).
`list_ideacloud_suggestions`	List unresearched topic suggestions to start an IdeaCloud from (read-only).
`list_images`	List the dealership’s Media Library images with alt text, AI metadata, and article links.
`list_layouts`	List available content layouts.
`list_search_pages`	List warehoused landing pages from Search Console.
`list_search_queries`	List warehoused search queries for the lookback window.
`list_social_posts`	List social posts.
`list_traffic_pages`	GA4 top pages from the warehouse.
`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`	Replace the IdeaCloud basket with a confirmed 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_image`	Wait for an image generation to finish.
`wait_for_media_session`	Wait for prepared social media processing.
`wait_for_social_post`	Wait for a social post to reach a terminal state.
`wait_for_vehicle_description`	Wait for a VIN’s description generation to finish.

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.

Interactive cards and client support

Some results come with an interactive card (MCP Apps): inventory cards with an in-place market analysis, pricing tables, lot-health and price-analysis insights, the dealership briefing, content lists, social posts and reviews, IdeaCloud research, and the compliance report — a findings table with the flagged text, the recommended wording, and what the dealer already decided. Card buttons hand a request to the chat (fix this finding, dismiss it in Hrizn, re-check); the assistant confirms before anything stored changes. Clients that do not render cards receive the same data as text — nothing is lost.

Client	Interactive cards	Async jobs	Confirmations	Long waits
Claude (web, desktop, mobile)	Yes	Task handle, polled by the card	In-chat form	Streams with progress
Claude Code	Text	Job block + `get_job` / `wait_for_*`	Dry-run preview + `user_confirmed`	Streams with progress ticks
ChatGPT (connector)	Yes	Job block, polled by the card	In-chat form	Streams
OpenAI Codex (CLI / desktop)	Text	Job block + `get_job` / `wait_for_*`	Dry-run preview + `user_confirmed`	Streams
Cursor	Text	Job block + `wait_for_*`	Dry-run preview + `user_confirmed`	Buffered (24 s waits)
Google Antigravity	Text	Job block + `wait_for_*`	Dry-run preview + `user_confirmed`	Buffered (24 s waits)
MCP Inspector	Yes	Task handle	In-chat form	Streams

Cards are served from the same endpoint (ui://hrizn/*.html resources); there is nothing extra to install.

Connect manually

The easiest setup is the MCP page in Hrizn (/{your-group}/mcp): save dealerships, copy the Streamable HTTP with OAuth URL, and follow a client walkthrough. CLI and other clients only need that URL.

https://mcp.app.hrizn.io/mcp

Legacy API keys (migration only)

Existing integrations may still use the REST MCP URL with an hzk_ API key from Dealership Manager → API (REST keys only — not the MCP page):

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

The read profile is the safest starting point for API-key clients. Use another profile only when the key has the matching scopes.

Cursor (manual fallback)

Install Hrizn from Cursor Directory when you can. Otherwise add this to .cursor/mcp.json or Cursor Settings → Tools & MCP:

{
  "mcpServers": {
    "hrizn": {
      "url": "https://mcp.app.hrizn.io/mcp"
    }
  }
}

Claude Code (legacy API key)

Prefer the Hrizn Claude plugin. Add this only when OAuth is unavailable:

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

OpenCode

For OAuth, add https://mcp.app.hrizn.io/mcp to your OpenCode MCP configuration and complete the Hrizn sign-in flow. Legacy API-key clients can use ?profile=read with the X-API-Key header.

Amazon Q / Kiro

Add an HTTP MCP server at https://mcp.app.hrizn.io/mcp for OAuth. Legacy setups may use https://api.app.hrizn.io/v1/public/mcp?profile=read with X-API-Key.

OpenAI Codex (legacy API key)

Add this to ~/.codex/config.toml only for API-key migration:

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

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

Try these prompts

“Which rooftops am I connected to? Brief me on lot aging for the primary store.”
“Find 2024–2025 RAV4s under $40k and outline a landing page from dealer context.”
“Start an IdeaCloud on used hybrid SUVs, wait for research, then create content after I approve the selection.”
“Check this ad copy for OEM compliance issues; don’t apply fixes until I confirm.”
“Draft replies to unanswered 1–2 star reviews and publish only what I approve.”
“Compare local days supply and flag price-cut candidates for 90-day trucks.”
“Load dealer context and the top content opportunities so I can brief the creative team.”
“Who are the sales managers at this store?”
“Which published articles can I cite with a live URL?”
“Create a model landing page for the 2026 Honda Civic Sport.”
“Schedule a Facebook post for Saturday at 10:00 AM.”

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.

Scheduled posts and event dates are sent as UTC timestamps. Tell the assistant your timezone (or let it confirm the dealership’s suggested_timezone) so it converts correctly — it should never assume UTC.
Every tool description ends with the API scope it requires, so the assistant can tell you up front when a grant lacks access.

Security

Save dealership grants only for rooftops you intend to expose to AI clients.
OAuth tokens are scoped to your Hrizn account; revoke access from your AI client when no longer needed.
Legacy API keys are shown once — treat them like passwords and revoke unused keys from Dealership Manager → API.
Do not share media upload links.

Troubleshooting

Grant required (403): Open MCP in Hrizn, select at least one dealership, save, then reconnect the client.
The connection is unauthorized: Sign out and back in through the OAuth flow, or create a new legacy API key if you still use hzk_ auth.
Codex sign-in fails with Unknown client: https://chatgpt.com/oauth/codex/…: The server URL differs from https://mcp.app.hrizn.io/mcp (usually a trailing slash). Codex derives its OAuth client id from the URL, so fix the URL in ~/.codex/config.toml or the MCP settings and run codex mcp login hrizn again.
ChatGPT/Codex callback “site can’t be reached” on 127.0.0.1: Auth0 finished; the local listener closed. Run codex mcp login hrizn and complete sign-in in that session.
A capability is unavailable: Check your plan (Teams+ for API Access, Unlimited for Market Maker and Social Hub writes) and the saved grant.
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 at https://mcp.app.hrizn.io/mcp, not a docs-only MCP.
New tools do not appear: Restart the AI client after saving a new grant or reconnecting OAuth.

Getting Started

Concepts

Guides

Scopes

Get started (OAuth)

Claude Desktop

Claude Code

OpenAI ChatGPT / Codex

Cursor

Google Antigravity

Other supported clients

What you can do

Understand your dealership

Work with inventory

Work with search and traffic

Plan and create content

Check OEM compliance

Use Hrizn Market Maker

Tool catalog

IdeaCloud text-first curation checklist

Interactive cards and client support

Connect manually

Legacy API keys (migration only)

Cursor (manual fallback)

Claude Code (legacy API key)

OpenCode

Amazon Q / Kiro

OpenAI Codex (legacy API key)

Try these prompts

Before making changes

Security

Troubleshooting

​Get started (OAuth)

​Claude Desktop

​Claude Code

​OpenAI ChatGPT / Codex

​Cursor

​Google Antigravity

​Other supported clients

​What you can do

​Understand your dealership

​Work with inventory

​Work with search and traffic

​Plan and create content

​Check OEM compliance

​Manage social activity

​Use Hrizn Market Maker

​Tool catalog

​IdeaCloud text-first curation checklist

​Interactive cards and client support

​Connect manually

​Legacy API keys (migration only)

​Cursor (manual fallback)

​Claude Code (legacy API key)

​OpenCode

​Amazon Q / Kiro

​OpenAI Codex (legacy API key)

​Try these prompts

​Before making changes

​Security

​Troubleshooting

​Related

Get started (OAuth)

Claude Desktop

Claude Code

OpenAI ChatGPT / Codex

Cursor

Google Antigravity

Other supported clients

What you can do

Understand your dealership

Work with inventory

Work with search and traffic

Plan and create content

Check OEM compliance

Manage social activity

Use Hrizn Market Maker

Tool catalog

IdeaCloud text-first curation checklist

Interactive cards and client support

Connect manually

Legacy API keys (migration only)

Cursor (manual fallback)

Claude Code (legacy API key)

OpenCode

Amazon Q / Kiro

OpenAI Codex (legacy API key)

Try these prompts

Before making changes

Security

Troubleshooting

Related