Connect Natural to AI agents

Connect Natural to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

get_transfer

Get Transfer

Retrieve a Natural transfer by ID.

revoke_agent_customer

Revoke Agent Customer

DEPRECATED — use `revoke_customer_agent` instead. Revoke a Natural agent's access to act for one customer using the legacy agent-side endpoint. Provide an idempotency key and reuse it when retrying. Returns the revoked relationship status, customer and agent references, raw customer record, and deletion metadata.

update_party

Update Party

Update the authenticated Natural party's display name, or clear it with null. Returns the updated identity, status, contact details, address, lifecycle timestamps, relationships, and raw metadata.

rotate_agent_key

Rotate Agent Key

Rotate a Natural agent key and return the one-time replacement secret only in output.agentKey, together with its complete lifecycle and ownership metadata. Requires confirmation and an idempotency key; reuse the same key when retrying the same rotation.

revoke_api_key

Revoke API Key

Revoke a Natural API key by ID so it can no longer authenticate. Requires confirmation and an idempotency key; reuse the same key when retrying the same revocation.

revoke_party_invitation

Revoke Party Invitation

Revoke a pending Natural party invitation by ID. This destructive operation requires confirmation and an idempotency key; reuse the same key when retrying the same revocation.

list_wallets

List Wallets

List wallets for the authenticated Natural party, or for an authorized delegated party when partyId is provided. Returns stable wallet, balance, ownership, lifecycle, and deposit fields plus each raw wallet resource.

approve_approval

Approve Approval

Approve a Natural payment or transfer under review. This can release money movement, is not documented as idempotent, and requires confirmation.

delete_webhook

Delete Webhook

Delete a Natural webhook by ID. Requires explicit confirmation and an idempotency key, and returns the deleted webhook ID, status, non-secret raw resource, and response metadata.

list_webhooks

List Webhooks

List Natural webhooks with optional status filtering.

get_approval

Get Approval

Retrieve a Natural approval by ID, including its status, target, reasons, and resolution timestamps.

get_api_key

Get API Key

Retrieve non-secret metadata for a Natural API key by its apy_* ID, including its name, status, scopes, prefix, environment, and lifecycle timestamps. The key secret is never returned.

list_customers

List Customers

List Natural customers. Natural defaults this endpoint to 20 records.

list_external_accounts

List External Accounts

List linked Natural external bank accounts visible to the authenticated party. Returns stable lifecycle, connection-health, bank, account-mask, ownership, and raw resource fields with cursor pagination.

get_webhook

Get Webhook

Retrieve a Natural webhook by ID, including its delivery URL, status, subscribed events, tags, timestamps, and owning party. Signing secrets are never returned.

create_agent_key

Create Agent Key

Create a Natural agent key bound to an existing agent and return its lifecycle and ownership metadata plus the one-time secret only in output.agentKey. Requires confirmation.

list_agent_keys

List Agent Keys

List Natural agent keys. Secrets are not returned by this list endpoint.

create_party_invitations

Create Party Invitations

Create 1-100 Natural party invitations for email recipients with ADMIN, MEMBER, or VIEWER access. Returns actionable invitation IDs, lifecycle fields, raw resources, and per-recipient failures. This endpoint is not documented as idempotent.

delete_agent

Delete Agent

Delete a Natural agent by ID and revoke the agent's active customer authorizations and pending invitations. Provide an idempotency key and reuse it when retrying the same deletion.

list_party_invitations

List Party Invitations

List Natural invitations to join the authenticated party, with optional party, recipient email, status, and cursor pagination filters. Returns actionable invitation IDs, roles, lifecycle timestamps, pagination metadata, and raw invitation resources.

cancel_payment_request

Cancel Payment Request

Cancel an open Natural payment request your party created and return its complete canceled resource plus response metadata. This mutates live state; set confirm to true, verify the current status before retrying, and reuse the same idempotency key for every retry.

create_payment

Create Payment

Create a Natural payment. This moves money or starts money movement; set confirm to true and reuse the same idempotency key on retries.

get_party

Get Party

Retrieve the authenticated caller's Natural party identity, including names, status, contact details, address, lifecycle timestamps, relationships, and raw metadata.

list_events

List Events

List Natural party events with optional event-type and created-time filters, returning stable event and resource IDs, payload snapshots, ownership metadata, raw provider records, and cursor pagination.

revoke_customer_invitation

Revoke Customer Invitation

Cancel a pending Natural customer delegation invitation by its adi_* ID. Returns the canceled invitation, its ID and status, and deletion metadata. This endpoint is not documented as idempotent.

get_customer

Get Customer

Retrieve a Natural customer who has authorized one of your agents by party ID, including delegation and connected-agent details.

create_agent

Create Agent

Create a Natural agent for the authenticated party. Provide an idempotency key and reuse it when retrying.

revoke_customer_agent

Revoke Customer Agent

Remove one Natural agent's access to a customer by pty_* customer ID and agt_* agent ID. This destructive action requires confirmation, sends a bodyless DELETE, and has no documented idempotency key. Returns the customer and agent IDs, current customer delegation status, raw customer resource, and deletion metadata.

list_counterparties

List Counterparties

List aggregated counterparties through Natural provider-deprecated legacy directional endpoints. Choose sent for recipients of payments from your agents or received for senders to your agents. Returns aggregate payment activity, identity fields, raw resources, and raw response metadata with cursor pagination.

create_webhook

Create Webhook

Create a Natural webhook, return its delivery and ownership metadata, and expose the one-time signing secret only in output.signingSecret.

invite_agent_customer

Invite Agent Customer

DEPRECATED — use `create_customer_invitations` instead. Invite 1-100 customers to authorize a Natural agent with specific permissions and an optional per-transaction limit. Provide an idempotency key and reuse it when retrying the same invitation batch.

list_api_keys

List API Keys

List Natural party API keys. Secrets are not returned by this list endpoint.

remove_party_member

Remove Party Member

Remove a member from the authenticated Natural party by user ID. This destructive operation requires confirmation and an idempotency key; reuse the same key when retrying the same removal.

decline_payment_request

Decline Payment Request

Decline an open Natural payment request and return its lifecycle, payer, requester, and relationship metadata. This mutates live state; set confirm to true and reuse the same idempotency key on retries.

remove_external_account

Remove External Account

Remove (unlink) a linked Natural external account so the current link can no longer be used as a funding source. Requires explicit confirmation, is not documented as idempotent, and returns the removed account resource, lifecycle status, and deletion metadata.

fulfill_payment_request

Fulfill Payment Request

Fulfill an open Natural payment request from a wallet or external account and return payment lifecycle, money, and relationship metadata. This moves money; set confirm to true and reuse the same idempotency key on retries.

list_agent_invitations

List Agent Invitations

List Natural agent delegation invitations through the provider-deprecated legacy endpoint. Filter by lifecycle status, customer email, or agent ID. Returns raw invitation resources, pagination, and raw provider metadata.

revoke_agent_invitation

Revoke Agent Invitation

DEPRECATED — use `revoke_customer_invitation` instead. Cancel a pending Natural agent delegation invitation through the legacy agent-side endpoint. Returns the canceled invitation, its ID and status, and deletion metadata. Provide an idempotency key and reuse it when retrying the same revocation.

update_webhook

Update Webhook

Update a Natural webhook by ID, returning its delivery URL, status, subscribed events, tags, timestamps, and owning party. Signing secrets are never returned.

get_transaction

Get Transaction

Retrieve one payment or transfer transaction visible to the authenticated Natural party, or to a delegated party when partyId is provided. Returns stable monetary, lifecycle, and relationship fields plus the raw transaction resource.

update_agent

Update Agent

Update a Natural agent's name, description, handle slug, or owner spending limits. Provide an idempotency key and reuse it when retrying the same update. Omitted top-level fields remain unchanged.

list_payments

List Payments

List Natural payments with optional party filtering and cursor pagination.

get_payment_request

Get Payment Request

Retrieve a Natural payment request your party created or was asked to pay, including lifecycle, payer, requester, wallet, payment, and transaction metadata.

list_agent_customers

List Agent Customers

DEPRECATED — use `list_customers` instead. List customers delegated to a Natural agent.

get_wallet

Get Wallet

Retrieve one Natural wallet by ID. Returns stable lifecycle, balance, claims, deposit, ownership, and raw wallet fields.

list_customer_invitations

List Customer Invitations

List pending Natural customer delegation invitations grouped by recipient, including the actionable per-agent invitation IDs. Natural defaults the page size to 20.

rotate_webhook_secret

Rotate Webhook Secret

Rotate a Natural webhook signing secret and return the one-time new secret only in output.signingSecret, together with the previous-secret expiry and owning-party metadata. Requires confirmation.

list_party_members

List Party Members

List active members of the authenticated Natural party with cursor pagination. Returns Natural user IDs, names, email addresses, roles, statuses, lifecycle timestamps, raw member resources, and response metadata.

list_transactions

List Transactions

List payment and transfer transactions visible to the authenticated Natural party; these are not payment request records. Supports type, counterparty, wallet, delegated-customer, delegated-only filters, and cursor pagination.

list_incoming_payment_requests

List Incoming Payment Requests

List open Natural payment requests that the effective party has been asked to pay.

list_transfers

List Transfers

List Natural transfers for the authenticated party, or an authorized delegated party, with cursor pagination. Returns transfer direction, money, lifecycle state, relationship IDs, timestamps, failure or return details, and the raw transfer resource.

deposit_funds

Deposit Funds

Initiate a Natural deposit from a linked external account into a wallet. This moves money; set confirm to true and reuse the same idempotency key when retrying the same deposit.

list_approvals

List Approvals

List Natural approvals for payment, deposit, or withdrawal decisions.

revoke_agent_key

Revoke Agent Key

Revoke a Natural agent key by its agk_* ID so it can no longer authenticate. Other active keys for the same agent keep working. Requires confirmation and an idempotency key; reuse the same key when retrying the same revocation.

deny_approval

Deny Approval

Deny a Natural payment or transfer under review. This blocks money movement, is not documented as idempotent, and requires confirmation.

list_agents

List Agents

List Natural agents with optional status filtering and cursor pagination.

get_event

Get Event

Retrieve a Natural event by ID, including the triggering resource, point-in-time payload snapshot, timestamp, owning party, relationships, and raw provider metadata.

cancel_payment

Cancel Payment

Cancel a Natural payment before the recipient begins claiming it. This destructive state transition requires confirm=true and an idempotency key; reuse the same key when retrying the same cancellation.

get_agent

Get Agent

Retrieve a Natural agent by ID, including its name, handle, status, owner limits, timestamps, owning party, and raw provider record.

list_payment_requests

List Payment Requests

List Natural payment requests created by the effective party.

create_payment_request

Create Payment Request

Create a Natural payment request for an email, phone, party, agent, or handle payer and return its payment link plus lifecycle metadata. This creates an externally actionable request; set confirm to true and reuse the same idempotency key on retries.

withdraw_funds

Withdraw Funds

Initiate a Natural withdrawal from a wallet to a linked external account. This moves money; set confirm to true and reuse the same idempotency key when retrying the same withdrawal.

create_customer_invitations

Create Customer Invitations

Create Natural customer delegation invitations for 1-100 email, phone, or party recipients and 1-50 agents. Returns one actionable invitation ID per recipient-agent pair plus failed-recipient metadata. This endpoint is not documented as idempotent.

who_am_i

Who Am I

Get the Natural party, effective acting party, acting agent, credential resolution details, and permissions associated with the authenticated connection.

create_api_key

Create API Key

Create a Natural party API key and return the one-time key secret in output.apiKey. Requires confirmation.

get_payment

Get Payment

Retrieve a Natural payment by ID.

More integrations teams use with Natural

GitHub

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.

Salesforce

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. Subscribe to real-time change events via Change Data Capture and Platform Events. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

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. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.

Airtable

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.

Sentry

Track, manage, and resolve application errors and performance issues. List, query, and bulk-update issues and error events with filters like status, assignment, and tags. Create and manage releases, associate commits, and upload source maps. Configure issue alert rules and metric alert rules with notification actions. Set up cron monitors to detect missed or failed scheduled jobs. Build custom dashboards with configurable widgets. Run ad-hoc Discover queries across errors and transactions for performance analysis. Manage organizations, teams, projects, and members. Provision users via SCIM. Access session replay data. Receive webhooks for issues, errors, alerts, comments, and installation events.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

Technical notes for Natural

Manage Natural agentic payments workflows through the REST API. List and manage agents, customer delegations, wallets, counterparties, payments, transfers, payment requests, approvals, party members, API keys, agent keys, webhooks, and events with explicit confirmation gates for high-risk money movement and destructive actions.

Connect Natural to production AI agents

See how Metorial gives Natural access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Natural to AI agents with Metorial.

  1. Can Metorial connect Natural to AI agents?
    Yes. Metorial connects AI agents to Natural through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.