Connect ngram over MCP

ngram is a native Model Context Protocol server, so Claude, eligible ChatGPT web workspaces and authenticated MCP-aware clients can create videos, check status and read credits as tool calls.

Written By Anish Muppalaneni

Last updated 1 day ago

Read before this

Choose how to automate ngram and connect integrations

Use this when

Use this guide when you want an AI assistant to use ngram tools, a connector asks for the ngram MCP server URL, authentication is unclear, tools do not appear after connecting, or ChatGPT can read ngram data but cannot create a video. MCP is for supported external AI clients; use the REST API or an automation connector when your system does not support remote MCP servers.

What this does not do

Connecting ngram does not add MCP support to an incompatible client or override the client's plan, developer-mode, workspace-app, or tool-approval rules. It also does not make a secret safe to paste into a conversation.

Before you start

Sign in to ngram and to the MCP client you intend to use. Confirm that the client supports remote HTTP MCP servers and whether it offers its own connector sign-in or accepts an Authorization header. Never paste an ngram key into chat, a prompt, a shared document, or a screenshot.

Overview

The Model Context Protocol is an open standard for connecting AI assistants to external tools. ngram exposes every public endpoint as an MCP tool with a typed schema the agent reads at connect time, so there is no glue code to write. Use the hosted HTTP endpoint for setup.

Connect to the hosted server (recommended)

Use https://mcp.ngram.com as the remote MCP server URL. Claude connector flows handle auth in the connector UI. In ChatGPT, full create-video actions currently require the web app on Business, Enterprise, or Edu, plus developer-mode and workspace app access; Pro is limited to read/fetch MCP actions. Header-capable clients can authenticate with Authorization: Bearer ngs_…. Every signed-in ngram user can create that bearer credential from Settings → API Keys. Connector flows that handle authentication in their own UI do not require you to paste a key.

Do not paste this JSON into a connector UI that only asks for a server URL. In those clients, add ngram as a custom or remote connector using https://mcp.ngram.com and follow the auth flow the client presents. The hosted endpoint is the supported default for normal setup.

Connect and verify the server

Open the client's connectors, integrations, or MCP settings and choose its action for adding a custom remote server.
Enter https://mcp.ngram.com as the server URL. Use the connector's sign-in flow when it offers one.
For a header-capable client only, create a key at ngram Settings → API Keys, store it in the client's secure credential field, and send it as an Authorization bearer header.
Finish the connection and review the tools the client discovered. Ask a read-only question such as “How many ngram credits do I have left?” before starting a render.

What you should see

The client should show ngram as connected and expose account, catalog, video, and image tools permitted by that client's plan and workspace policy. A credit question should return the authenticated ngram account's plan and balance. Creating a video starts a server-side job; the client can check its status and return the final link when it completes.

Tool catalog

Every ngram endpoint maps to a discrete tool. The agent reads the typed schema for each at connect time, so it can pick the right one without a docs lookup mid-conversation.

Account

get_account — return the authenticated ngram account.
get_credits_remaining — return the credit balance and plan.

Catalog

list_voices, list_styles, list_aspect_ratios, list_durations — the options a render can use.
list_animation_modes, list_scenarios, list_brand_kits — resolve modes, presets and your brand kits.

Videos

create_video_from_text and create_video_from_url — start a render from a prompt or a source URL.
prepare_video then create_video — preview the resolved settings, then confirm and generate.
get_video_status, list_videos, cancel_video — track, list and stop renders.

Images

create_image, edit_image, get_image_status, list_images — generate and edit images the same way.

Example prompts

Once connected, just ask in plain language — the agent picks the right tool:

"Make a 30-second product teaser for our pricing page and tell me when it's done."
"How many credits do I have left?"
"List my last five videos and their status."

If authentication or tools do not work

Confirm that the server URL is exactly https://mcp.ngram.com and that you did not paste the JSON configuration into a URL-only field.
Check the signed-in ngram account, the MCP client's plan, developer-mode setting, and workspace app permissions. In ChatGPT, Pro can read or fetch through MCP but cannot start an ngram video render.
Disconnect and reconnect ngram once, then repeat the read-only credit check. Do not repeatedly replace keys or retry a create action while the connection state is uncertain.

Contact Support when

Contact Support when one reconnect still leaves ngram unauthorized, no tools are discovered, a read-only tool returns the wrong account, or an eligible create action is missing. Include the client name and version, account plan, workspace type, server URL, approximate time, and the visible error with all keys and personal data removed. Never send an API key or authorization header.

MCP server FAQ

Which MCP clients are supported?

We test Claude Desktop, Cursor, Cline, Notion AI and eligible ChatGPT apps. Custom clients that support remote MCP servers and compatible authentication use the same tool schema.

Which endpoint should I use?

Use the hosted endpoint at https://mcp.ngram.com. Connector UIs ask for the URL and then handle auth in their own flow; header-capable clients can add a bearer header.

How do I authenticate?

Claude and ChatGPT authenticate inside their connector UI, so those flows do not require you to create or paste an ngram key. For a header-capable hosted HTTP client, every signed-in user can create a key in Settings → API Keys and send it as Authorization: Bearer ngs_….

What tools does the server expose?

Account, catalog, video and image tools — from get_credits_remaining and list_voices to create_video_from_text, get_video_status and create_image. Each has a typed JSON schema the agent reads at connect time.

Are there rate limits?

Yes — the same public-API limits apply. Up to three video jobs can be processing per account at once; the agent surfaces a rate-limit response when you exceed it.

Why are ngram tools not showing after I added the server?

Check that the URL is exactly https://mcp.ngram.com, finish the connector's authentication flow, and confirm the client supports remote HTTP MCP servers. Disconnect and reconnect once, then contact Support if no ngram tools appear.

Why can ChatGPT see ngram but not create a video?

ChatGPT creation actions currently require ChatGPT web on Business, Enterprise, or Edu with developer mode and workspace app access. Pro MCP access is limited to read and fetch actions.

Should I paste my ngram API key into the conversation?

No. Connector-managed flows handle sign-in in their own UI. A header-capable custom client should store the key in its secure credential or header field, never in a prompt, message, or screenshot.

Keep going

Getting started — Create a key and learn the create → poll → webhook lifecycle.
MCP integration overview — The product story behind the ngram MCP server.
Zapier — Automate ngram across thousands of apps with no code.

Ready to connect ngram?

Use the hosted server URL and complete authentication in your connector. For header-capable custom clients, create a bearer credential in Settings → API Keys.

Review connection steps