Ask your agent in plain language. Each of these maps to a real tool on the server.
text_completion
Generate text from a single prompt using Writer's Palmyra models. Unlike chat completion, this takes a plain text prompt and returns a text continuation. Best for single-turn text generation tasks like summarization, rewriting, or content creation.
download_file
DEPRECATED — use `download_original_file` instead. Download the content of a file by its ID as text.
delete_file
Permanently delete a file discovered with list_files. The file will be disassociated from all Knowledge Graphs. This action cannot be undone.
get_agent_details
Retrieve details of a no-code agent discovered with list_agents, including its required inputs, configuration, and capabilities. Use this to understand what inputs are needed before invoking an agent.
list_files
List files uploaded to Writer. Returns file metadata including ID, name, status, and associated Knowledge Graph IDs. Supports pagination and ordering.
add_file_to_graph
Add an uploaded file to a Knowledge Graph. Call list_knowledge_graphs and list_files to discover IDs. Upload the file with upload_file and wait for get_file to report completed before adding it.
query_knowledge_graph
Ask a question to one or more Knowledge Graphs discovered with list_knowledge_graphs and get an AI-generated answer grounded in your uploaded data. Returns the answer, source references, and optional inline citations. Supports subquery decomposition for complex questions.
invoke_agent
Run a deployed no-code agent (application) as a microservice by providing its required inputs. Returns the generated output. Use **List Agents** first to find the agent ID and required input fields.
get_knowledge_graph
Retrieve details and file ingestion status for a Knowledge Graph. Call list_knowledge_graphs to discover IDs.
list_knowledge_graphs
List a page of accessible Knowledge Graphs in your Writer account. Returns the ID, name, description, and creation date of each graph.
create_knowledge_graph
Create a new Knowledge Graph in Writer. A Knowledge Graph is a collection of files used for RAG-based question answering. After creation, add files to it using add_file_to_graph.
chat_completion
Generate AI responses from conversation history using Writer's Palmyra models. Supports multi-turn conversations with system, user, and assistant messages. Can leverage **tool calling** with custom functions, Knowledge Graph queries, and web search. Use **response format** to get structured JSON output (compatible models).
list_agents
List deployed no-code agents (applications) in your Writer account. Returns agent metadata including IDs, names, and types. Use this to discover available agents and their application IDs before invoking them.
list_models
List available Palmyra and configured external models in your Writer account. Returns model IDs and names. Use this to discover which models are available for text generation and chat completions.
delete_knowledge_graph
Permanently delete a Knowledge Graph and disassociate all its files. Call list_knowledge_graphs to discover IDs. This action cannot be undone.
remove_file_from_graph
Remove a file from a Knowledge Graph. Call list_knowledge_graphs and list_files to discover IDs. The file can be re-added later or used with other graphs.
update_knowledge_graph
Update the name and/or description of an existing Knowledge Graph. Call list_knowledge_graphs to discover IDs.
get_file
Retrieve metadata for a file discovered with list_files, including the file name, processing status, and associated Knowledge Graphs.
download_original_file
Prepare an uploaded Writer file discovered with list_files for download, preserving the original binary content.
upload_file
Upload a text or binary file to Writer for Knowledge Graphs or agent inputs. Optionally associate it with a graph. Retrieve the file afterward to confirm the graph association.
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.
Generate text and chat responses using available Palmyra and external models. Use custom function calling, Knowledge Graph retrieval, web search, and structured JSON responses. Create and manage Knowledge Graphs, upload and manage text or binary files, prepare original files for download, and invoke deployed no-code agents. Discover models, graphs, files, and agents with list tools.
Common questions about connecting Writer to AI agents with Metorial.
