Servers Playground How we check Add a server Log in

Suprsonic

Working · 1.7 s

io.github.O-mega-Enterprise/suprsonic-mcpv0.3.4

One API key, dozens of capabilities for your AI agent. Zero provider auth.

Web Search Design & Creative

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://suprsonic.ai/v1/mcp

Authorization (required)

Your Suprsonic API key as a bearer token (get one at suprsonic.ai/app/api)

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

bg-remove Read-only

Remove background from any image. Returns transparent PNG. Returns the cut-out as a base64 PNG with a transparent background. Use to isolate the subject of an existing image. To create a new image use images. Cost: 2 credits, charged only when a call succeeds.

image_urlstring, required

URL to image.

sizestring

Output resolution.

Suprsonic MCP server | mcptry

Tools (24)

Tool list last changed Oct 25, 2026.

bg-remove

read-only

Argument	Type	Description
size	string	Output resolution.
image_url*	string	URL to image.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "image_url"
  ],
  "properties": {
    "size": {
      "enum": [
        "auto",
        "small",
        "hd"
      ],
      "type": "string",
      "default": "auto",
      "description": "Output resolution."
    },
    "image_url": {
      "type": "string",
      "description": "URL to image."
    }
  }
}

code-execute

Execute code in a secure sandbox with pre-configured environments. Returns stdout, stderr, the exit code, the run time, and the files the code wrote to /home/user/output/ as base64. Use for calculations, data processing and running scripts. Each call runs in a fresh sandbox that is destroyed afterwards, so nothing carries over from one call to the next. Cost: 2 credits, charged only when a call succeeds.

Argument	Type	Description
code*	string	The code to execute.
timeout	number	Max execution time (1-300s).
language	string	Programming language.
template	string	Pre-configured environment.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "The code to execute."
    },
    "timeout": {
      "type": "number",
      "default": 30,
      "description": "Max execution time (1-300s)."
    },
    "language": {
      "enum": [
        "python",
        "javascript",
        "shell"
      ],
      "type": "string",
      "default": "python",
      "description": "Programming language."
    },
    "template": {
      "enum": [
        "default",
        "data-science",
        "web-dev",
        "video"
      ],
      "type": "string",
      "default": "default",
      "description": "Pre-configured environment."
    }
  }
}

companies

Enrich company data by domain. Returns the company's name, description, industry, size, founding year, headquarters, employees, revenue, funding, social links, technologies, logo and brand colors. Use for business facts about a company. For technical facts about its domain (WHOIS, DNS, SSL, hosting) use site-intel; for a person use profiles. Cost: 3 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
domain*	string	Company domain.
company_name	string	Optional name hint.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Company domain."
    },
    "company_name": {
      "type": "string",
      "description": "Optional name hint."
    }
  }
}

documents

Extract structured data from URLs or content. Returns the extracted data as JSON (shaped by your schema when you pass one), with the source URL and whether long content was truncated. Use to turn a page or a text into structured fields. For a page's full text use scrape; for invoices and receipts use invoice-parse. Pass url or content; extraction_prompt says what to extract, and schema fixes the shape of the JSON you get back. Cost: 3 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
url	string	URL to scrape and extract from.
schema	object	JSON schema for extraction.
content	string	Pre-scraped text content.
extraction_prompt*	string	What to extract (required unless schema is provided).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "extraction_prompt"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to scrape and extract from."
    },
    "schema": {
      "type": "object",
      "description": "JSON schema for extraction.",
      "additionalProperties": true
    },
    "content": {
      "type": "string",
      "description": "Pre-scraped text content."
    },
    "extraction_prompt": {
      "type": "string",
      "description": "What to extract (required unless schema is provided)."
    }
  }
}

domains

Find domain names and the extensions that fit a business. Returns, by mode, name ideas with prices, extensions that fit with reasons, one name across extensions, availability for a list of domains, prices per extension, or the extension catalog. Use to name a business or check domains before buying one; it never registers or buys a domain. For facts about a domain that is already live use site-intel. mode decides which fields apply: company_name and description for the suggest modes, query for search-extensions, domains for check-availability, tlds for pricing. Cost: suggest-names 5 credits, suggest-extensions 3 credits, search-extensions 2 credits, check-availability 1 credit, pricing 1 credit, tlds 1 credit, charged only when a call succeeds.

read-only

Argument	Type	Description
mode	string	Which domain capability to run.
tlds	array	Extensions to price (pricing), to check the name across (search-extensions), or to restrict name ideas to (suggest-names).
query	string	An exact name to check across extensions (search-extensions).
offset	number	search-extensions: pagination offset into the catalog.
domains	array	Full domains to check, e.g. ["brewhaven.com"] (check-availability).
purpose	string	What the domain is for (suggest-names / suggest-extensions): website (the site address), cold (a dedicated cold-email domain, kept apart from the site) or extra. Context the model weighs when judging fit; it sets no search options, which are yours to choose (search_options) from what the company needs.

email-verify

Check if an email is deliverable, catch-all, or disposable. Returns the status (such as valid, invalid or catch-all) with a sub-status, whether it is a free mailbox, a suggested correction, the domain's age and its mail servers. Use before emailing an address you were given or found. To find an address from a person's name use emails. Cost: 1 credit, charged only when a call succeeds.

read-only

Argument	Type	Description
email*	string	Email to verify.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email to verify."
    }
  }
}

emails

Find professional email addresses. Returns the address with its confidence (0 to 1) and verification status. Use to find a named person's work email at a company. To check an address you already have use email-verify; for the person's background use profiles. Cost: 2 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
domain*	string	Company domain.
company	string	Company name (optional).
last_name*	string	Last name.
first_name*	string	First name.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "first_name",
    "last_name",
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Company domain."
    },
    "company": {
      "type": "string",
      "description": "Company name (optional)."
    },
    "last_name": {
      "type": "string",
      "description": "Last name."
    },
    "first_name": {
      "type": "string",
      "description": "First name."
    }
  }
}

file-convert

Convert documents, web pages, spreadsheets and images between formats. Returns a download URL of the converted file with its name, size and formats. Use to change a file's format, for example Word to PDF or PDF to Markdown. To extract specific fields use documents; to read a web page's text use scrape. Cost: 2 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
file_url*	string	URL of the file to convert (for source_format web, the page itself).
source_format*	string	Format of the file: pdf, docx, pptx, xlsx, csv, html, web (a page, from its HTML without JavaScript), txt, epub, svg, png, jpg, webp, gif, bmp, tiff or heic.
target_format	string	Format to convert to. The conversion table's pairs convert in-house; other pairs go to ConvertAPI.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "file_url",
    "source_format"
  ],
  "properties": {
    "file_url": {
      "type": "string",
      "description": "URL of the file to convert (for source_format web, the page itself)."
    },
    "source_format": {
      "type": "string",
      "description": "Format of the file: pdf, docx, pptx, xlsx, csv, html, web (a page, from its HTML without JavaScript), txt, epub, svg, png, jpg, webp, gif, bmp, tiff or heic."
    },
    "target_format": {
      "type": "string",
      "default": "pdf",
      "description": "Format to convert to. The conversion table's pairs convert in-house; other pairs go to ConvertAPI."
    }
  }
}

images

Generate images from text prompts. Returns a hosted URL of the PNG and the same image as base64 (b64_json), with the aspect ratio and size used. Use to create a new picture from a description. To cut the background out of an existing image use bg-remove; to capture a web page use screenshot. Cost: 3 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
prompt*	string	Image description.
aspect_ratio	string	Aspect ratio.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Image description."
    },
    "aspect_ratio": {
      "enum": [
        "1:1",
        "16:9",
        "9:16"
      ],
      "type": "string",
      "default": "1:1",
      "description": "Aspect ratio."
    }
  }
}

invoice-parse

Extract structured data from invoices and receipts. Returns the invoice number, dates, supplier and customer, currency, subtotal, tax, total and every line item. Use for an invoice or receipt given as a PDF or image URL. For any other document use documents with your own schema. Cost: 3 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
document_url*	string	URL to invoice PDF/image.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "document_url"
  ],
  "properties": {
    "document_url": {
      "type": "string",
      "description": "URL to invoice PDF/image."
    }
  }
}

profiles

Find and enrich professional profiles. Returns the person's name, headline, current company and title, location, summary, experience, education, skills, photo URL and LinkedIn URL. Use to learn who a professional is and what they have done. For their work email use emails; for a company rather than a person use companies. Pass linkedin_url, or first_name and last_name; company helps find the right person. Cost: 3 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
company	string	Company name.
last_name	string	Last name.
first_name	string	First name.
linkedin_url	string	LinkedIn profile URL.
include_image	boolean	Fetch profile image.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Company name."
    },
    "last_name": {
      "type": "string",
      "description": "Last name."
    },
    "first_name": {
      "type": "string",
      "description": "First name."
    },
    "linkedin_url": {
      "type": "string",
      "description": "LinkedIn profile URL."
    },
    "include_image": {
      "type": "boolean",
      "default": true,
      "description": "Fetch profile image."
    }
  }
}

research

Multi-step deep research: search, scrape, enrich entities, and synthesize into a cited report. Returns a report (title, summary, sections, key findings, confidence) with numbered sources and the people and companies it found, enriched. Use for a question that needs many sources and a synthesized, cited answer. It takes far longer and costs more than search, which suits a quick fact. Cost: standard 10 credits, deep 20 credits, comprehensive 35 credits, charged only when a call succeeds. Options change it: include_analysis true +5, academic in source_types +2, enrich_entities false -3, synthesis false -5.

read-only

Argument	Type	Description
depth	string	Research depth.
query*	string	The research question or objective.
freshness	string	Time filter for search results.
synthesis	boolean	Generate a synthesized report. Set false for raw mode (sources + entities only).
max_sources	number	Maximum number of sources to collect.
source_types	string	Comma-separated source types: web, news, academic.
enrich_entities	boolean	Enrich detected people and companies with profile and firmographic data.

scrape

Extract content from any URL as Markdown or HTML. Returns the page's content in the chosen format (Markdown by default) with its title, description and links. Use when you have a URL and need what the page says. Start with fast; use standard for pages that need JavaScript and thorough only for sites that block scrapers. To pull specific fields into JSON use documents; to see the page as an image use screenshot. Cost: fast 1 credit, standard 2 credits, thorough 5 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
url*	string	URL to scrape.
mode	string	Mode: fast (Raw HTTP, no JS. <1s), standard (Full JS rendering. 2-5s), thorough (Anti-bot proxies + JS rendering. 10-30s).
output	string	Content format.
timeout	number	Seconds the page may take to load (up to 55).
wait_for	string	CSS selector to wait for (standard and thorough modes).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to scrape."
    },
    "mode": {
      "enum": [
        "fast",
        "standard",
        "thorough"
      ],
      "type": "string",
      "description": "Mode: fast (Raw HTTP, no JS. <1s), standard (Full JS rendering. 2-5s), thorough (Anti-bot proxies + JS rendering. 10-30s)."
    },
    "output": {
      "enum": [
        "markdown",
        "html",
        "raw_html"
      ],
      "type": "string",
      "default": "markdown",
      "description": "Content format."
    },
    "timeout": {
      "type": "number",
      "default": 30,
      "description": "Seconds the page may take to load (up to 55)."
    },
    "wait_for": {
      "type": "string",
      "description": "CSS selector to wait for (standard and thorough modes)."
    }
  }
}

screenshot

Capture a rendered screenshot of any webpage. Returns the image as base64 with its format, dimensions and size in bytes. Use to see how a page looks. To read its text use scrape. Cost: 1 credit, charged only when a call succeeds.

read-only

Argument	Type	Description
url*	string	URL to capture.
width	number	Viewport width.
format	string	Output format.
height	number	Viewport height.
full_page	boolean	Capture full scrollable page.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to capture."
    },
    "width": {
      "type": "number",
      "default": 1280,
      "description": "Viewport width."
    },
    "format": {
      "enum": [
        "png",
        "jpg",
        "webp"
      ],
      "type": "string",
      "default": "png",
      "description": "Output format."
    },
    "height": {
      "type": "number",
      "default": 720,
      "description": "Viewport height."
    },
    "full_page": {
      "type": "boolean",
      "default": false,
      "description": "Capture full scrollable page."
    }
  }
}

Search the web with SERP, AI synthesis, or both. Returns, by mode: serp the organic results (title, url, snippet, position) with any knowledge graph and featured snippet; ai a written answer with the URLs it cites; deep both. Use for current facts, news and finding pages. To read one page in full use scrape; for a report built from many sources use research. Cost: serp 1 credit, ai 2 credits, deep 3 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
mode	string	Mode: serp (Raw Google SERP results), ai (AI-synthesized answers with citations), deep (SERP + AI synthesis combined).
query*	string	The search query.
country	string	ISO country code of the Google results (serp and deep modes).
freshness	string	Only sources from this window, in every mode.
num_results	number	Maximum number of organic results (serp and deep modes).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "mode": {
      "enum": [
        "serp",
        "ai",
        "deep"
      ],
      "type": "string",
      "description": "Mode: serp (Raw Google SERP results), ai (AI-synthesized answers with citations), deep (SERP + AI synthesis combined)."
    },
    "query": {
      "type": "string",
      "description": "The search query."
    },
    "country": {
      "type": "string",
      "default": "us",
      "description": "ISO country code of the Google results (serp and deep modes)."
    },
    "freshness": {
      "enum": [
        "any",
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "default": "any",
      "description": "Only sources from this window, in every mode."
    },
    "num_results": {
      "type": "number",
      "default": 10,
      "description": "Maximum number of organic results (serp and deep modes)."
    }
  }
}

site-intel

Get comprehensive domain intelligence: WHOIS, DNS, SSL, tech stack, email security, hosting. Returns, by mode, the registration (WHOIS) data, DNS records with email security, the technology stack, a security grade from A to F, or the subdomains; overview combines registration, DNS, SSL and hosting. Use for technical facts about a domain. For business facts about the company behind it use companies; to find a name you can register use domains. Cost: overview 2 credits, whois 1 credit, dns 1 credit, tech-stack 2 credits, security 2 credits, subdomains 2 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
mode	string	Intelligence depth.
domain*	string	Domain to analyze (e.g. stripe.com).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "mode": {
      "enum": [
        "overview",
        "whois",
        "dns",
        "tech-stack",
        "security",
        "subdomains"
      ],
      "type": "string",
      "default": "overview",
      "description": "Intelligence depth."
    },
    "domain": {
      "type": "string",
      "description": "Domain to analyze (e.g. stripe.com)."
    }
  }
}

sms

Send SMS or WhatsApp messages. Default channel is SMS (reliable delivery). WhatsApp requires recipient opt-in: they must have messaged your Business number within 24 hours. Returns the message id, channel, recipient, sender number and send status. Sends a real message to a phone number: a sent message cannot be recalled, and every call sends a new one. Use it to text a number the user gave you. Cost: 1 credit, charged only when a call succeeds.

Argument	Type	Description
to*	string	Phone number (E.164).
channel	string	Delivery channel. Auto sends via SMS. WhatsApp requires opt-in: recipient must have messaged your Business number in the last 24 hours, otherwise the message is silently dropped by Meta.
message*	string	Message text.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "to",
    "message"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Phone number (E.164)."
    },
    "channel": {
      "enum": [
        "auto",
        "sms",
        "whatsapp"
      ],
      "type": "string",
      "default": "auto",
      "description": "Delivery channel. Auto sends via SMS. WhatsApp requires opt-in: recipient must have messaged your Business number in the last 24 hours, otherwise the message is silently dropped by Meta."
    },
    "message": {
      "type": "string",
      "description": "Message text."
    }
  }
}

sound-generate

Generate sound effects and short music tracks from text prompts (NOT speech: use tts for spoken voice). Returns the audio as base64 with its format, sample rate and duration. Use for sound effects, ambience and short instrumental music. It produces no spoken words: for speech use tts. Cost: 4 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
prompt*	string	Description of the sound effect or music to generate. NOT for speech (use tts for spoken voice).
output_format	string	Audio format and quality.
duration_seconds	number	Length of generated audio in seconds (0.5 to 22). Leave unset to let the model auto-decide based on the prompt.
prompt_influence	number	How strictly to follow the prompt (0.0 = creative, 1.0 = literal). Default 0.3.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Description of the sound effect or music to generate. NOT for speech (use tts for spoken voice)."
    },
    "output_format": {
      "enum": [
        "mp3_44100_128",
        "mp3_44100_192",
        "pcm_44100"
      ],
      "type": "string",
      "default": "mp3_44100_128",
      "description": "Audio format and quality."
    },
    "duration_seconds": {
      "type": "number",
      "description": "Length of generated audio in seconds (0.5 to 22). Leave unset to let the model auto-decide based on the prompt."
    },
    "prompt_influence": {
      "type": "number",
      "default": 0.3,
      "description": "How strictly to follow the prompt (0.0 = creative, 1.0 = literal). Default 0.3."
    }
  }
}

stt

Transcribe audio to text with timestamps. Returns the transcript, its confidence, language and duration, and every word with its start and end time. Use for a short clip whose exact words and timings you need. For a long recording with several speakers use transcribe; for caption files use subtitle. Pass audio_url, or the audio itself as audio_base64. Cost: 2 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
language	string	Language code.
audio_url	string	URL to audio file.
audio_base64	string	Base64-encoded audio.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "default": "en",
      "description": "Language code."
    },
    "audio_url": {
      "type": "string",
      "description": "URL to audio file."
    },
    "audio_base64": {
      "type": "string",
      "description": "Base64-encoded audio."
    }
  }
}

subtitle

Generate SRT/VTT subtitles from audio or video. Returns the subtitles as SRT or VTT text with the language, duration and number of cues. Use to caption a video or an audio file. For a plain transcript use stt or transcribe. Cost: 2 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
format	string	Subtitle format.
language	string	Language code.
audio_url*	string	URL to audio/video.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "audio_url"
  ],
  "properties": {
    "format": {
      "enum": [
        "srt",
        "vtt"
      ],
      "type": "string",
      "default": "srt",
      "description": "Subtitle format."
    },
    "language": {
      "type": "string",
      "default": "en",
      "description": "Language code."
    },
    "audio_url": {
      "type": "string",
      "description": "URL to audio/video."
    }
  }
}

transcribe

Transcribe audio with speaker diarization and timestamps. Returns the full transcript with its confidence, language, duration, word and speaker counts, and the utterances, each with its speaker and start and end time. Use for meetings, interviews and podcasts, where who spoke when matters. For a short clip's word timings use stt; for caption files use subtitle. Cost: 3 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
language	string	Language code.
audio_url*	string	URL to audio/video file.
speaker_labels	boolean	Enable speaker diarization.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "audio_url"
  ],
  "properties": {
    "language": {
      "type": "string",
      "default": "en",
      "description": "Language code."
    },
    "audio_url": {
      "type": "string",
      "description": "URL to audio/video file."
    },
    "speaker_labels": {
      "type": "boolean",
      "default": true,
      "description": "Enable speaker diarization."
    }
  }
}

tts

Convert text to speech audio. Returns the speech as base64 MP3 audio with its sample rate and the voice used. Use for spoken voice or narration, up to 2,000 characters a call. For sound effects or music use sound-generate. Cost: 2 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
text*	string	Text to convert (max 2000 chars).
provider	string	TTS provider.
voice_model	string	Deepgram voice model ID.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Text to convert (max 2000 chars)."
    },
    "provider": {
      "enum": [
        "auto",
        "deepgram",
        "elevenlabs"
      ],
      "type": "string",
      "default": "auto",
      "description": "TTS provider."
    },
    "voice_model": {
      "type": "string",
      "description": "Deepgram voice model ID."
    }
  }
}

video-download

Download video from any URL and return a temporary download link. Returns a download link that expires after one hour, with the file name, size, duration, quality, format, title and thumbnail. A download that takes longer than about a minute and a half (every YouTube download) answers status processing with a job_id instead: call again with that job_id to get the file. Use to get a video, or only its audio, as a file. For its details without downloading use video-info. Cost: video 3 credits, audio 2 credits, charged only when a call succeeds.

read-only

Argument	Type	Description
url	string	URL of the video or post containing a video. Send this, or job_id to collect a download in progress.
format	string	Output format.
job_id	string	The job_id of an answer whose status was processing: send it instead of url to get the file once it is ready. Checking is free; the call that returns the file is charged.
quality	string	Desired video quality (best available up to this resolution).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL of the video or post containing a video. Send this, or job_id to collect a download in progress."
    },
    "format": {
      "enum": [
        "mp4",
        "mp3",
        "m4a"
      ],
      "type": "string",
      "default": "mp4",
      "description": "Output format."
    },
    "job_id": {
      "type": "string",
      "description": "The job_id of an answer whose status was processing: send it instead of url to get the file once it is ready. Checking is free; the call that returns the file is charged."
    },
    "quality": {
      "enum": [
        "360",
        "480",
        "720",
        "1080",
        "best"
      ],
      "type": "string",
      "default": "720",
      "description": "Desired video quality (best available up to this resolution)."
    }
  }
}

video-info

Extract video metadata, available formats, and thumbnail from any URL. Returns the title, duration, thumbnail, uploader, upload date, view count, platform and the available formats with their sizes. Use to inspect a video before downloading it. To get the file use video-download; for what is said in it use transcribe. Cost: 1 credit, charged only when a call succeeds.

read-only

Argument	Type	Description
url*	string	URL of the video or post containing a video.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "URL of the video or post containing a video."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "mode": {
      "enum": [
        "suggest-names",
        "suggest-extensions",
        "search-extensions",
        "check-availability",
        "pricing",
        "tlds"
      ],
      "type": "string",
      "default": "suggest-names",
      "description": "Which domain capability to run."
    },
    "tlds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Extensions to price (pricing), to check the name across (search-extensions), or to restrict name ideas to (suggest-names)."
    },
    "query": {
      "type": "string",
      "description": "An exact name to check across extensions (search-extensions)."
    },
    "offset": {
      "type": "number",
      "default": 0,
      "description": "search-extensions: pagination offset into the catalog."
    },
    "domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Full domains to check, e.g. [\"brewhaven.com\"] (check-availability)."
    },
    "purpose": {
      "enum": [
        "website",
        "cold",
        "extra"
      ],
      "type": "string",
      "description": "What the domain is for (suggest-names / suggest-extensions): website (the site address), cold (a dedicated cold-email domain, kept apart from the site) or extra. Context the model weighs when judging fit; it sets no search options, which are yours to choose (search_options) from what the company needs."
    },
    "company_id": {
      "type": "string",
      "description": "Optional O-mega/Founden company id; pulls the real business brief to ground the fit."
    },
    "description": {
      "type": "string",
      "description": "What the business does; grounds the fit (suggest-* modes)."
    },
    "company_name": {
      "type": "string",
      "description": "The business name (suggest-extensions), or for suggest-names a natural-language brief: any ordering or limit it states (for example \"shortest\" or \"renewal under $15\") is read and applied beneath your explicit search_options."
    },
    "search_options": {
      "type": "object",
      "description": "Search options, only the fields you set (suggest-names / search-extensions / suggest-extensions): priorities (objective keys in priority order: total_length, annual_price, renewal_price, registration_total, semantic_fit, brandability, label_length), max_total_length and max_label_length (characters), max_annual_price, max_renewal_price and max_registration_total (USD), hacks (include, exclude or only) and allow_premium (boolean). A field you set wins over what the company_name brief asks for; null (or priorities: []) leaves that field to the brief; unknown keys are rejected. Options that do not apply to a mode are ignored there. The response echoes the effective options (search-extensions: search_options; suggest-names: search_plan.search_options).",
      "additionalProperties": true
    },
    "exact_extension": {
      "type": "boolean",
      "default": false,
      "description": "search-extensions: check ONLY the typed extension."
    }
  }
}