THE CONNECTOR
Every lens on the platform, one endpoint away from your agent. Search the catalog, grade a screenplay, forecast a slate, all without leaving the conversation.
ONE ENDPOINT
https://hollywoodmetrics.ai/mcp
Streamable HTTP transport in stateless JSON mode. Send JSON-RPC via POST with Accept: application/json, text/event-stream. No sessions, no SSE stream to babysit; any request can land on any instance. Business denials (quota, tier, scope) come back as tool results with isError, never as HTTP errors.
TWO WAYS IN
Use your existing platform key as Authorization: Bearer hm_... or X-API-Key. Mint keys at /dashboard/api-keys (paid tiers). Works in every header-capable host.
Connect with no credentials at all and you are in sandbox mode: read-only tools, 25 requests per day per IP. The right speed for kicking the tires from hosts that cannot send custom headers yet.
| Tier | Daily requests | Scopes |
|---|---|---|
| Sandbox (no key) | 25 / day per IP | Read-only tryout, zero signup |
| Writer | 10 / day | Read scope |
| Producer | 200 / day | Read scope |
| Studio | 10,000 / day | Read, write, and AI scopes |
One tool call is one request, identical to the REST API. The get_account_status tool is free and reports what you have left.
SEVENTEEN TOOLS
search_filmsSearch and filter 74,000+ films with sort and paginationget_filmFull canonical record: ratings, box office, awards, cast, crewget_similar_filmsCurated similarity picks for one filmget_poster_analysisStructured visual read of a theatrical posterrecommend_filmsTaste-profile recommendations from liked and disliked titlesget_catalog_statsAggregate distributions across the whole catalogsearch_scriptsBrowse the 1,571-screenplay research set by tierget_scriptOne ranked screenplay with its 20-feature vectoranalyze_screenplayTier prediction and feature percentiles for raw textpredict_project_outcomeGross, rating, and ROI forecast for a project packagelist_style_guidesScreenwriter, director, and cinematographer style guidesget_style_guideOne full guide by name or slugai_script_coverageProfessional coverage of screenplay textai_rewrite_sceneScene rewrite in a named screenwriter's voiceget_account_statusTier, scopes, and remaining quota. Free, unmeteredsearch / fetchResearch-connector contract for hosts that require itCONNECT YOUR HOST
claude mcp add --transport http hollywood-metrics https://hollywoodmetrics.ai/mcp \ --header "Authorization: Bearer hm_YOUR_KEY"
{
"mcpServers": {
"hollywood-metrics": {
"url": "https://hollywoodmetrics.ai/mcp",
"headers": { "Authorization": "Bearer hm_YOUR_KEY" }
}
}
}{
"servers": {
"hollywood-metrics": {
"type": "http",
"url": "https://hollywoodmetrics.ai/mcp",
"headers": { "Authorization": "Bearer hm_YOUR_KEY" }
}
}
}Both major model APIs accept remote MCP servers with a static authorization token. Point them at the endpoint and pass your key as the token.
"mcp_servers": [{
"type": "url",
"url": "https://hollywoodmetrics.ai/mcp",
"name": "hollywood-metrics",
"authorization_token": "hm_YOUR_KEY"
}]Paste the endpoint URL as a custom connector with no authentication and you get the sandbox tier. Research connectors work out of the box: the server implements the standard search and fetch contract with citation links back to the film pages. Full OAuth sign-in for these hosts is on the roadmap.