Ask your agent in plain language. Each of these maps to a real tool on the server.
manage_connection
Import existing credentials, retrieve metadata, or delete one exact connection/integration pair from list_connections. Credentials are never delivered. A full-access key may refresh credentials during a read; prefer read permissions without credential scopes. Import can replace existing authorization or cause connection hooks. Deletion does not guarantee upstream revocation or retained-history erasure.
trigger_action
Execute one deployed Nango action synchronously for an exact connection/integration pair. Call list_functions for native action names and required input. This can write to the connected provider or send messages; effects may remain after a timeout. No automatic retry occurs. Recognized credential fields are redacted from the returned result.
list_connections
List authorized connection/integration pairs and credential-free metadata in the connected environment. Returns one native page; a full page does not prove the inventory is complete. Use least-privilege list permissions without credential scopes.
proxy_request
Request a provider endpoint through an exact Nango connection/integration pair from list_connections. Nango injects provider authorization. Requests can create irreversible provider effects; this is not a dry run. Credential/token/session endpoints and arbitrary origin overrides are unavailable. Recognized credential fields are redacted from results; only JSON/text responses up to the local 10 MiB cap are supported.
get_records
Retrieve one page of synced records for an exact connection and deployed data model. Discover integration/connection IDs with list_connections and model names with list_functions. Preserve native opaque cursors. Pages can be smaller than limit while more data exists; continue until nextCursor is absent. Concurrent updates may repeat records. Recognized credential fields are redacted.
manage_sync
Trigger, start, pause or inspect deployed syncs. Discover exact sync names with list_functions. Start executes immediately and enables scheduling; trigger queues a run, not a completed result. Pause affects scheduling and does not prove an active run was cancelled. Reset clears checkpoints; emptyCache also removes cached records. Provider side effects or execution history may remain.
manage_connection_metadata
Set or update metadata for exact connection/integration pairs from list_connections. Set replaces the entire metadata object; update overwrites only supplied properties. Read back every target to verify state. Bulk requests may have retained effects if the response is uncertain.
manage_integration
Create, update, retrieve or delete one exact integration. Call list_integrations and list_providers for authorized IDs and provider names. Outputs contain metadata only. Deletion can affect connected users, deployed functions and retained provider history; it does not promise upstream credential revocation or erasure.
list_integrations
List configured integrations in the connected Nango environment with exact IDs and provider names. Credentials are not delivered. This native collection has no documented pagination; responses above the local 2,000-entry safety limit are refused.
create_connect_session
Connect session creation is unavailable through public tools because the native result grants connection-creation access. Use the Nango Connect UI through a trusted backend for secure end-user authorization. This retained key does not mint a session or send a request.
list_providers
Discover the native provider catalog with exact provider names and authentication modes for integration creation. This collection has no documented pagination; results above the local 2,000-provider safety limit are refused. No provider credentials or authorization sessions are requested.
list_functions
Discover one native page of functions deployed to an exact integration from list_integrations. Use returned names, types, input schemas and model names before invoking actions, managing syncs or fetching records. Requires environment:functions:list; does not execute or download function source.
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.
Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.
Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.
Discover authorized Nango integrations, providers, connections and deployed functions. Inspect synced records and native sync state, manage exact integration and connection metadata, and invoke supported deployed actions or authenticated provider requests. Credentials and Connect session tokens are not delivered; session authorization requires a trusted Nango backend.
Common questions about connecting Nango to AI agents with Metorial.
