Ask your agent in plain language. Each of these maps to a real tool on the server.
run_model
Run synchronous inference on any Fal.ai model endpoint with arbitrary input parameters. This is a generic tool for calling any model that doesn't have a dedicated tool, including 3D generation, image editing, upscaling, and other specialized models. Pass model-specific parameters directly and receive model output with downloadable files when produced.
upload_file
Copy a public file of up to 90 MiB to Fal.ai CDN storage from a URL. The uploaded file can then be referenced by its CDN URL in model inference requests. Useful for providing input images, audio, or video files to Fal.ai models.
search_models
Search and discover available model endpoints on Fal.ai. Supports listing all models, searching by text query or category, and looking up specific models by endpoint ID. Returns model metadata including name, description, category, and status.
transcribe_audio
Transcribe audio files to text using Fal.ai speech recognition models like Whisper (Wizper). Supports speaker diarization, language detection, and word/segment-level timestamps. Provide an audio URL and receive a full transcription with optional metadata.
generate_image
Generate images from text prompts or transform existing images using Fal.ai models such as FLUX, Stable Diffusion, Ideogram, Recraft, and more. Supports text-to-image and image-to-image generation with configurable parameters like image size, guidance scale, LoRA adapters, and safety settings. Runs synchronously and provides downloadable generated images. Model parameters vary; use search_models with includeSchema=true to inspect the selected endpoint.
generate_speech
Generate speech audio from text using Fal.ai text-to-speech models. Model-specific options support language selection and reference-audio voice cloning when available. Provides a downloadable audio file. Inspect endpoint inputs with search_models using includeSchema=true.
generate_video
Generate videos from text prompts, images, or other videos using Fal.ai models such as Kling, LTX, Veo, Sora, and more. Supports text-to-video, image-to-video, and video-to-video transformations. Runs synchronously and provides a downloadable video. Prefer submit_queue_request for slow models; inspect endpoint parameters with search_models using includeSchema=true.
submit_queue_request
Submit an asynchronous inference request to Fal.ai's queue system. This is the recommended approach for long-running model inference. Returns a request ID for polling status or retrieving results later. Optionally provide a webhook URL to receive results automatically upon completion.
check_queue_status
Check the status of an asynchronous queue request on Fal.ai and optionally retrieve the result. Use after submitting a request with the Submit Queue Request tool. Use action="result" after completion to retrieve model output and downloadable files. action="cancel" requests cancellation; running inference may still finish.
get_model_pricing
Get the current unit price, billing unit, and currency for fal.ai model endpoints before running paid inference. Discover endpoint IDs with search_models. Final cost can depend on resolution, duration, and model-specific billing rules.
get_account
Identify the authenticated fal.ai account and retrieve its credit balance. Requires an ADMIN-scoped API key; ordinary model inference and discovery use API-scoped keys.
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.
Discover fal.ai models and their input schemas, inspect current pricing, generate downloadable images, videos, and speech, transcribe audio, upload public input files, and run arbitrary model inference. Submit asynchronous requests, poll results, or request cancellation. ADMIN-scoped keys can also identify the account and read its credit balance.
Common questions about connecting Falai to AI agents with Metorial.
