Maton Service Orchestrator for AI Agents

Introduction

This component, the Maton Agent Toolkit, empowers leading agent architectures, including those following the Model Context Protocol (MCP), to interface with Maton's proprietary APIs utilizing function invocation. This strategic integration supports businesses in refining their customer relationship management processes, enabling them to analyze interactions and enhance customer satisfaction across diverse data sources. The library does not encompass the entirety of the Maton API offerings.

Related Topics

• Customer Relationship Management (CRM) Strategy
• Data-Driven Customer Interaction Optimization
• Model Context Protocol (MCP) Specifications
• SaaS Platform API Interoperability
• Sales Cycle Forecasting and Customer Pattern Analysis

Setup

To begin utilizing this software component, you must first secure an API authentication key from your designated Maton administrative portal. Subsequently, review the comprehensive API documentation provided by Maton for advanced parameters. TypeScript language support is included within this library.

If you intend only to consume the package's functionality without source code modifications, use the following installation command:

npm install @maton/agent-toolkit

Requirements

Operation necessitates an execution environment running Node version 18 or newer.

Usage

Model Context Protocol

The Maton Agent Toolkit explicitly incorporates functionality to serve the requirements of the Model Context Protocol (MCP).

To initiate the Maton MCP server instance using the npx runner, execute the subsequent command line instruction:

API Agent (Beta)

npx -y @maton/mcp hubspot --agent --api-key=YOUR_MATON_API_KEY

API Action Execution

To configure the system to employ all supported API operations, run this command:

npx -y @maton/mcp hubspot --actions=all --api-key=YOUR_MATON_API_KEY

# Alternatively, specify discrete actions for execution
npx -y @maton/mcp hubspot --actions=create-contact,list-contacts --api-key=YOUR_MATON_API_KEY

Remember to substitute YOUR_MATON_API_KEY with your actual secret key obtained previously. Alternatively, key management allows setting the MATON_API_KEY as an environment variable for system access. The keys are retrievable via the Maton Dashboard.

Usage with Claude Desktop

Integrate the following configuration block into your claude_desktop_config.json file. Consult the official quickstart guide for further configuration specifics.

{
  "mcpServers": {
    "maton": {
      "command": "npx",
      "args": [
        "-y",
        "@maton/mcp@latest",
        "hubspot",
        "--actions=all",
        "--api-key=YOUR_MATON_API_KEY"
      ]
    }
  }
}

Ensure the placeholder YOUR_MATON_API_KEY is replaced with your current secret key. Setting the MATON_API_KEY within your operational environment variables presents another secure method for key provision.

Available API actions

This table details the specific external service integrations and the functions accessible through this toolkit.

App	Action
airtable	list-bases
airtable	list-records
airtable	list-tables
asana	create-task
asana	get-task
asana	list-projects
asana	list-tasks
asana	list-workspaces
aws	get-s3-object
aws	list-s3-buckets
aws	list-s3-objects
calendly	get-event
calendly	list-event-invitees
calendly	list-event-types
calendly	list-events
clickup	create-task
clickup	delete-task
clickup	get-task
clickup	list-folders
clickup	list-lists
clickup	list-spaces
clickup	list-tasks
clickup	list-workspaces
google-calendar	create-event
google-calendar	delete-event
google-calendar	get-calendar
google-calendar	get-event
google-calendar	list-calendars
google-calendar	list-events
google-calendar	update-event
google-docs	append-text
google-docs	create-document
google-docs	find-document
google-docs	get-document
google-drive	create-file
google-drive	create-folder
google-drive	delete-file
google-drive	find-file
google-drive	find-folder
google-drive	get-file
google-drive	list-files
google-mail	add-label-to-email
google-mail	create-draft
google-mail	find-email
google-mail	list-labels
google-mail	send-email
google-mail	remove-label-from-email
google-sheet	add-column
google-sheet	add-multiple-rows
google-sheet	clear-cell
google-sheet	clear-rows
google-sheet	create-spreadsheet
google-sheet	create-worksheet
google-sheet	delete-rows
google-sheet	delete-worksheet
google-sheet	find-row
google-sheet	get-cell
google-sheet	get-spreadsheet
google-sheet	get-values-in-range
google-sheet	list-worksheets
google-sheet	update-cell
google-sheet	update-multiple-rows
google-sheet	update-row
hubspot	create-contact
hubspot	get-contact
hubspot	list-contacts
hubspot	search-contacts
hubspot	merge-contacts
hubspot	update-contact
hubspot	delete-contact
hubspot	create-deal
hubspot	get-deal
hubspot	list-deals
hubspot	search-deals
hubspot	merge-deals
hubspot	update-deal
hubspot	delete-deal
jira	list-clouds
jira	get-issue
jira	list-issues
jira	add-comment-to-issue
jira	list-comments
jira	update-comment
jira	list-projects
jira	get-user
jira	list-users
jotform	list-forms
jotform	list-submissions
klaviyo	add-profiles-to-list
klaviyo	assign-template-to-campaign-message
klaviyo	create-campaign
klaviyo	create-list
klaviyo	create-profile
klaviyo	create-template
klaviyo	get-campaign-messages
klaviyo	get-campaign-send-job
klaviyo	get-campaigns
klaviyo	get-lists
klaviyo	get-profiles-for-list
klaviyo	get-profiles
klaviyo	get-templates
klaviyo	send-campaign
mailchimp	get-campaign
mailchimp	search-campaign
notion	create-page
notion	find-page
notion	get-page
outlook	create-draft
outlook	find-email
outlook	send-email
pipedrive	search-people
salesforce	create-contact
salesforce	get-contact
salesforce	list-contacts
shopify	create-order
shopify	get-order
shopify	list-orders
slack	list-channels
slack	list-messages
slack	list-replies
slack	send-message
stripe	create-customer
stripe	create-invoice-item
stripe	create-invoice
stripe	delete-customer
stripe	get-customer
stripe	get-invoice
stripe	list-customers
stripe	list-invoices
typeform	get-form
typeform	list-forms
typeform	list-responses
youtube	list-videos
youtube	search-videos

Extra Details

The functionality mirrors structural patterns found in related agent toolkits, such as the one developed by Stripe, indicating a commitment to established interoperability standards. Effective CRM necessitates consolidating data from diverse communication streams, including web interactions, email correspondence, and social media engagement. This tool aids in centralizing these touchpoints for analytical purposes, supporting both current and prospective customer management workflows.

Conclusion

This library provides essential programmatic access, enabling AI agents to execute concrete sales and service operations within connected enterprise systems. By streamlining data flow, this orchestration layer directly supports the goal of improving customer retention and fostering revenue expansion, aligning with the broad strategic objectives of modern customer relationship management practices.