home / mcp / maton mcp server

Maton MCP Server

Provides MCP-based access to Maton APIs, enabling hub-specific actions via function calling.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "maton-ai-agent-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "@maton/mcp",
        "hubspot",
        "--agent",
        "--api-key",
        "YOUR_MATON_API_KEY"
      ],
      "env": {
        "MATON_API_KEY": "YOUR_MATON_API_KEY"
      }
    }
  }
}

The Model Context Protocol (MCP) lets you connect your preferred client to Maton APIs through function calling, enabling dynamic, context-aware actions across apps. This server bridges your MCP client with Maton’s API capabilities, so you can perform configured actions like managing contacts, tasks, events, and more directly from your MCP-enabled workflow.

How to use

Use MCP with your Maton setup by running the MCP server commands via your shell. You provide your Maton API key and choose the hub you want to expose as MCP endpoints. Once started, your MCP client can invoke the available actions for that hub and receive structured responses that you can incorporate into your conversations, automations, or decision-making logic.

How to install

Prerequisites: Node.js 18 or newer must be installed on your machine.

Install the Maton MCP toolkit package locally to enable MCP server access.

Install the MCP server client package and prepare your environment as you follow these steps.

Additional configuration and usage notes

To run the MCP server for HubSpot API actions, use the following command pattern. You must replace YOUR_MATON_API_KEY with your actual API key from your Maton dashboard. You may also export MATON_API_KEY in your environment.

Tools and available actions (hubspot and others)

The MCP server exposes a wide range of actions across many apps. For HubSpot, you can access contact-related actions such as creating, retrieving, listing, merging, updating, and deleting contacts, as well as deal-related operations. Other apps provide analogous CRUD-like or retrieval actions for their respective resources.

Security and keys

Protect your Maton API key. Do not expose it in public logs or shared code. Use environment variables when possible, and restrict access to systems that run the MCP server.

Available tools

create-contact

Create a new contact in HubSpot using the Maton MCP hubspot integration.

get-contact

Retrieve details for a specific HubSpot contact by ID or email.

list-contacts

List contacts in HubSpot with optional filtering and pagination.

merge-contacts

Merge two HubSpot contacts based on specified criteria.

update-contact

Update fields on an existing HubSpot contact.

delete-contact

Remove a HubSpot contact from HubSpot.

create-deal

Create a new deal in HubSpot.

get-deal

Fetch details for a specific HubSpot deal.

list-deals

List deals in HubSpot with optional filters.

search-deals

Search deals by criteria across HubSpot.

list-projects

List projects in supported integrations where applicable.

create-task

Create a task in a connected app (e.g., project management tool).

get-task

Retrieve details of a specific task.

list-tasks

List tasks within a project or workspace.

list-workspaces

List available workspaces in the connected app.