Ask your agent in plain language. Each of these maps to a real tool on the server.
manage_task
Manage a conversion task's lifecycle — update its file retention mode or permanently delete task files. **Retention modes:** - `standard_24h` — Default; files are deleted after 24 hours. - `ttl_15m` — Files are deleted after 15 minutes (paid plans only). **Delete** permanently removes all files associated with the task (paid plans only).
list_tasks
Lists up to 50 most recent conversion tasks. Optionally filter by status to find pending, running, successful, or failed tasks.
convert_file
Creates a file conversion task on Conversion Tools. Supports 100+ conversion types across documents, images, data formats, audio, video, eBooks, and subtitles. Provide either a **fileId** (from a previously uploaded file) or a **url** (for URL-based conversions like website capture or remote file conversion). The conversion runs asynchronously — use the **Get Task** tool to check completion status. Common conversion types include: `convert.pdf_to_word`, `convert.json_to_excel`, `convert.website_to_pdf`, `convert.mp4_to_mp3`, `convert.png_to_webp`, `convert.markdown_to_pdf`, `convert.ocr_png_to_text`, and many more. Use the **List Conversions** tool to see all available types and their options.
capture_website
Captures a website as a PDF, JPG, or PNG screenshot. Supports custom viewport dimensions, device emulation, page orientation, margins, and JavaScript rendering options. This is a convenience wrapper around the conversion types `convert.website_to_pdf`, `convert.website_to_jpg`, and `convert.website_to_png`.
get_file_info
Retrieves metadata about a file stored on Conversion Tools, including its name, size, and a text preview (if available). Useful for verifying uploaded source files or inspecting conversion results before downloading.
get_account
Retrieves the authenticated user's account information, including the email address associated with the API token.
download_file
Prepares a downloadable source or converted file by its file ID. Use the result file ID from Get Task after a successful conversion, before the file retention period expires.
get_task
Retrieves the current status and details of a conversion task. Use this to check if a conversion has completed and to get the result file ID for downloading.
list_conversions
Retrieves all available conversion types and their configurable options. Use this to discover what conversions are supported and what parameters each conversion type accepts. Each conversion type includes a type identifier (e.g. `convert.pdf_to_word`) and a list of options such as delimiter, quality, page orientation, etc.
upload_file
Uploads a source file to Conversion Tools and returns its file ID for Convert File. Provide the original filename and Base64-encoded file bytes.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.
Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.
Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.
Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.
Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.
Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.
Convert files between 100+ formats including documents (PDF, Word, Excel, PowerPoint), images (JPG, PNG, WebP, AVIF, HEIC), data formats (JSON, XML, CSV, YAML, Parquet), eBooks (ePUB, MOBI), audio/video (MP4, MP3, WAV), and subtitles (SRT, VTT). Extract text from images and scanned PDFs using OCR with 100+ language support. Capture websites as PDF or image screenshots with configurable viewport and device emulation. Transform structured data between JSON, XML, CSV, Excel, YAML, Parquet, JSONL, and BSON. Use AI-powered extraction to convert PDFs and images into structured JSON, Markdown, CSV, or Excel. Translate subtitles using AI across 30+ languages. Convert Markdown to PDF, HTML, ePUB, Word, or LaTeX. Remove EXIF metadata from images. Validate XML/XSD and format JSON. Conversion tasks run asynchronously with polling or webhook callback support for completion notifications.
Common questions about connecting Conversion Tools to AI agents with Metorial.
