Mediacinema.example.com

ScreenPulse

ScreenPulse turns a movie database and showtimes site into a unified media API. Look up titles, cast, ratings, and nearby screenings. Perfect for concierge and recommendation agents.

Auth: None
Latency: ~250ms
Volume: 940K / mo
Surfaces: REST · MCP

#movies#ratings#showtimes#media

Endpoints

Base URL https://corpus.bifra.dev/screenpulse

GET/titles

Search films and shows by title.

Parameters

qstring· queryrequired

Search query.

Sample response

JSON

{
  "titles": [
    {
      "id": "tt5820714",
      "title": "The Long Orbit",
      "year": 2025,
      "rating": 7.8,
      "genres": ["Sci-Fi", "Drama"]
    }
  ]
}

GET/showtimes

Find showtimes near a location.

Parameters

titleIdstring· queryrequired

Title identifier.

zipstring· queryrequired

Postal code.

Using the REST API

Call it from your own code, a script, or the terminal. Every response is typed and normalized. No authentication required.

cURL

curl "https://corpus.bifra.dev/screenpulse/titles?q=..."

Using the MCP server

Add the server to your agent's config and it gets typed tools instead of scraping the site. Works with any MCP-compatible client.

mcp.json

{
  "mcpServers": {
    "screenpulse": {
      "url": "https://corpus.bifra.dev/screenpulse/mcp"
    }
  }
}

Available tools

search_titles
Search films and shows.
get_showtimes
Find nearby screenings for a title.