# OpenGraph.io — how to use (mcp.ai)

Connect your OpenGraph.io account and use 4 tools for web scraping straight from your AI agent. Connect with your own API key. OpenGraph.io provides a simple API to retrieve Open Graph data from websites, even those without properly defined Open Graph tags.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_opengraph_io?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `opengraph_io_capture_screenshot`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/opengraph_io`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/opengraph_io/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/opengraph_io/capture/screenshot` — Tool to capture high-quality screenshots of any webpage programmatically. Supports full-page captures, custom dimensions, device presets, element-specific screenshots, and quality settings. Screenshot
  - body: { url: string, format?: string, quality?: integer, cache_ok?: boolean, selector?: string, dark_mode?: boolean, full_page?: boolean, use_proxy?: boolean, dimensions?: string, capture_delay?: integer, exclude_selectors?: string, navigationTimeout?: integer, block_cookie_banner?: boolean }
- `POST https://api.mcp.ai/api/opengraph_io/extract/site` — Tool to extract site metadata. Use when you need to retrieve Open Graph and other meta signals from a website.
  - body: { site: string, scrape?: boolean, use_proxy?: boolean, accept_lang?: string, full_render?: boolean }
- `POST https://api.mcp.ai/api/opengraph_io/scrape/site` — Tool to scrape a site for its raw HTML and social/OpenGraph metadata. Use when you need the full page content and metadata. Use after confirming the URL.
  - body: { site: string, scrape?: boolean, cache_ok?: boolean, full_render?: boolean }
- `POST https://api.mcp.ai/api/opengraph_io/scrape/url` — Tool to scrape raw HTML content from a website with anti-bot protection and optional JavaScript rendering. Use when you need the full HTML source code of a page, especially for sites with bot detectio
  - body: { url: string, cache_ok?: boolean, use_proxy?: boolean, accept_lang?: string, full_render?: boolean, use_premium?: boolean, use_superior?: boolean }

## Example prompts
- "What can I do in OpenGraph.io?"
- "Show me a summary of my OpenGraph.io account"

## More
- Page: https://mcp.ai/opengraph_io
- Agent spec (llms.txt): https://mcp.ai/opengraph_io/llms.txt
- Postman collection: https://mcp.ai/opengraph_io/postman.json