# Cinve

> Cinve is an open-source MCP server for design and media. Showtimes, ticket prices, concessions and seat maps for Venezuelan cinemas. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted, CLI
- **Website:** https://cinve.kevinbravo.com
- **Repository:** https://github.com/0bkevin/cinve
- **MCP Registry name:** com.kevinbravo.cinve/mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Cinve covers five Venezuelan chains: Cinex, Cines Unidos, Cinepic, Supercines and Gran Cine. You ask in plain language, for example what is showing in Caracas today or whether two seats together are still free, and the assistant answers from live cinema data.

Listings and showtimes need no account. Some prices and seat maps for Cinex and Cines Unidos need your cinema account, and the assistant hands you a private single-use link, valid for 10 minutes, to connect it. The password is entered only on that page, used once and never stored; the session is kept encrypted and can be disconnected at any time.

It is strictly read-only: it does not buy tickets or reserve seats, and seat maps mark seats as available, occupied or unconfirmed because availability can change before purchase. The author describes it as an independent, non-profit project with no cinema affiliation.

## Features

- **Five cinema chains:** Reads listings from Cinex, Cines Unidos, Cinepic, Supercines and Gran Cine.
- **Seat maps:** Shows available, occupied and unconfirmed seats so you can check for adjacent seats.
- **Prices and concessions:** Answers ticket price and combo questions where the chain exposes them.
- **Private account linking:** Single-use links expire in 10 minutes and the cinema password is never stored.
- **Read-only by design:** It cannot purchase tickets or hold seats.
- **Self-hostable:** Runs locally on Node.js 22 or later, or on your own server with PostgreSQL.

## Good for

- Find what is showing in Caracas tonight
- Compare ticket prices across chains
- Check whether two seats together are free for a showing
- Look up snack combos before going

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://cinve.kevinbravo.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cinve.kevinbravo.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://cinve.kevinbravo.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://cinve.kevinbravo.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://cinve.kevinbravo.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://cinve.kevinbravo.com/mcp"
    }
  }
}
```

## Tools

- `get_auth_status`: Status of the Cinex, Cines Unidos and Supercines sessions and the next connection step. The Supercines account is optional for prices (without it they are the public ones) and needed for its seat maps. Returns no personal data or secrets. configured does not guarantee that the provider has not revoked the session.
- `list_providers`: Lists providers and implemented coverage. This capability catalog does not perform a live availability check.
- `connect_account`: In hosted mode, starts Cinve authorization automatically when needed. If the account is already connected, returns connected=true: repeat the original query without asking the user for anything. Otherwise, returns connected=false and a private, single-use link for the user to connect their Cinex, Cines Unidos or Supercines account (Supercines shows public prices without an account, but its seat ma
- `disconnect_account`: Disconnects the user's cinema account in Cinve and cancels pending links. Does not revoke the session directly on the cinema's website. Use when the user asks to disconnect.
- `get_seats`: Actual seat map without booking: Cinex and Cines Unidos require cinema_id, session_id and a connected account; Cinepic also requires movie_id, without login; Supercines requires cinema_id, session_id, movie_id, date if the showtime is not today, and a connected account (its website shows the map only inside a purchase, so Cinve opens one with a single ticket, picks no seat and cancels it in the sa
- `list_cities`: Lists the provider's cities. Use their names when querying Cines Unidos.
- `list_cinemas`: Lists venues and IDs, with each venue's area. For a user who names where they are, pass near: venues come nearest first with distance_km. Cines Unidos requires city or near; Supercines accepts an optional city; Cinepic verifies its configured venues Candelaria and VVIP Lido. Providers keep known venues without a verified code (code_status=unverified). Cinex accepts an optional city and includes kn
- `list_movies`: Searches movies by name. Cinepic requires cinema_id (123300 Candelaria or 123301 VVIP Lido) and filters the day's showtimes; Cines Unidos requires city and allows cinema_id/date. Cinex returns the general catalog without date/venue: only provider, query and paging. Supercines returns its current listings (with presales), overall or for one venue with cinema_id, without a date. Gran Cine returns th
- `get_showtimes`: Gets showtimes for a date (today in Caracas by default). Cinepic requires cinema_id (123300 Candelaria or 123301 VVIP Lido); Cines Unidos requires city; Cinex accepts city for all its verified venues in the city in one call, cinema_id for one venue (with optional movie_id to filter), or only movie_id to read the movie's page across all venues; Supercines accepts cinema_id, city or movie_id; Gran C
- `get_ticket_prices`: Gets ticket prices (Gran Cine does not publish them). Cinepic requires cinema_id, movie_id and session_id from get_showtimes. Cines Unidos requires cinema_id, session_id and a connected account. Cinex requires cinema_id, session_id and a connected account. Supercines requires cinema_id, movie_id and session_id, and date if the showtime is not today; it does not require an account (if the user conn
- `get_concessions`: Gets concessions by venue. Cinepic and Cines Unidos require only cinema_id, via a public API; Cinepic may return an empty catalog. Cinex requires cinema_id and a connected account. Supercines requires only cinema_id. Stock only when verified; does not use zero for missing prices.

## FAQ

### Can it book tickets?

No. It is read-only and does not buy tickets or reserve seats.

### Do I need a cinema account?

Not for public listings. Some Cinex and Cines Unidos price and seat queries need you to connect your account through a private link.

### Is my cinema password stored?

The site says it is used once to sign in and never stored.

### What licence is it under?

The README lists the MIT licence.

### Is Cinve free?

Yes. Cinve is open source, so you can use and self-host it for free.

### How do I add Cinve to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://cinve.kevinbravo.com/mcp

### What are the best alternatives to Cinve?

The closest alternatives to Cinve are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/cinve
