{
  "name": "max",
  "version": "1.0.2",
  "kind": "product",
  "description": "Max's official local MCP server exposes buying-signal, business, subscription, lead, and webhook workflows to MCP-compatible agents.",
  "icon": "https://yourmax.ai/favicon.svg",
  "transport": "stdio",
  "command": "npx",
  "args": [
    "-y",
    "sortlist-max-mcp"
  ],
  "environment": {
    "MAX_API_KEY": {
      "required": true,
      "secret": true,
      "description": "A team-scoped Max API key."
    }
  },
  "package": {
    "registry": "npm",
    "name": "sortlist-max-mcp",
    "version": "1.0.2",
    "url": "https://www.npmjs.com/package/sortlist-max-mcp"
  },
  "repository": "https://github.com/sortlist/max-mcp",
  "documentation": "https://api.yourmax.ai/docs/api",
  "instructions": "Run with npx and provide MAX_API_KEY in the process environment. Use catalog tools without credentials only through the public REST endpoint; this stdio package itself requires MAX_API_KEY at startup. Review retrieved evidence before taking outreach actions.",
  "capabilities": {
    "tools": true,
    "resources": false,
    "prompts": false
  },
  "tools": [
    {
      "name": "list_signals",
      "description": "List every active signal type in Max's public catalog.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "get_signal",
      "description": "Get the description and configuration schema for one signal slug.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "The signal slug."
          }
        },
        "required": [
          "slug"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "list_businesses",
      "description": "List the businesses available to the authenticated Max team.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "get_business",
      "description": "Get one business and its Ideal Customer Profile.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          }
        },
        "required": [
          "business_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "create_business",
      "description": "Create a business from a website for automatic analysis, or from explicit business and ICP fields.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "website": {
            "type": "string",
            "format": "uri",
            "description": "Website URL."
          },
          "name": {
            "type": "string",
            "description": "Business name for manual creation."
          },
          "description": {
            "type": "string",
            "description": "Business description."
          },
          "ideal_customer_profile_attributes": {
            "type": "object",
            "properties": {
              "target_locations": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Target geographic locations."
              },
              "target_industries": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Target industries."
              },
              "company_types": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Target company types."
              },
              "company_sizes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Target company-size bands."
              },
              "description": {
                "type": "string",
                "description": "Free-text Ideal Customer Profile description."
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "update_business",
      "description": "Update an existing business or its Ideal Customer Profile.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "name": {
            "type": "string",
            "description": "Updated business name."
          },
          "website": {
            "type": "string",
            "format": "uri",
            "description": "Updated website URL."
          },
          "description": {
            "type": "string",
            "description": "Updated business description."
          },
          "ideal_customer_profile_attributes": {
            "type": "object",
            "properties": {
              "target_locations": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Target geographic locations."
              },
              "target_industries": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Target industries."
              },
              "company_types": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Target company types."
              },
              "company_sizes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Target company-size bands."
              },
              "description": {
                "type": "string",
                "description": "Free-text Ideal Customer Profile description."
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "business_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "list_subscriptions",
      "description": "List all signal-monitoring subscriptions for a business.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          }
        },
        "required": [
          "business_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "get_subscription",
      "description": "Get one signal-monitoring subscription.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "subscription_id": {
            "type": "string",
            "description": "The subscription ID."
          }
        },
        "required": [
          "business_id",
          "subscription_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "create_subscription",
      "description": "Create a named subscription to a signal for a business.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "signal_slug": {
            "type": "string",
            "description": "The signal slug to monitor."
          },
          "name": {
            "type": "string",
            "description": "A name for the subscription."
          },
          "config": {
            "type": "object",
            "description": "Configuration accepted by the selected signal.",
            "additionalProperties": true
          }
        },
        "required": [
          "business_id",
          "signal_slug",
          "name"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "update_subscription",
      "description": "Update a subscription's name or signal-specific configuration.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "subscription_id": {
            "type": "string",
            "description": "The subscription ID."
          },
          "name": {
            "type": "string",
            "description": "Updated subscription name."
          },
          "config": {
            "type": "object",
            "description": "Updated signal-specific configuration.",
            "additionalProperties": true
          }
        },
        "required": [
          "business_id",
          "subscription_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "pause_subscription",
      "description": "Pause a subscription so it stops collecting new leads.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "subscription_id": {
            "type": "string",
            "description": "The subscription ID."
          }
        },
        "required": [
          "business_id",
          "subscription_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "resume_subscription",
      "description": "Resume a paused subscription.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "subscription_id": {
            "type": "string",
            "description": "The subscription ID."
          }
        },
        "required": [
          "business_id",
          "subscription_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "delete_subscription",
      "description": "Permanently delete a signal-monitoring subscription.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "subscription_id": {
            "type": "string",
            "description": "The subscription ID."
          }
        },
        "required": [
          "business_id",
          "subscription_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "list_leads",
      "description": "List a business's discovered leads with pagination.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "Page number; defaults to 1."
          },
          "per_page": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Results per page; defaults to 25."
          }
        },
        "required": [
          "business_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "get_lead",
      "description": "Get one discovered lead and its delivery history.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "lead_id": {
            "type": "string",
            "description": "The lead ID."
          }
        },
        "required": [
          "business_id",
          "lead_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "delete_lead",
      "description": "Soft-delete a lead so it no longer appears in list results.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "lead_id": {
            "type": "string",
            "description": "The lead ID."
          }
        },
        "required": [
          "business_id",
          "lead_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "list_webhooks",
      "description": "List the webhook endpoints configured for a business.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          }
        },
        "required": [
          "business_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "create_webhook",
      "description": "Register an HTTPS endpoint for new-lead webhook notifications.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "HTTPS endpoint that will receive webhook POST requests."
          },
          "secret": {
            "type": "string",
            "description": "Optional secret used to sign payloads with HMAC-SHA256."
          }
        },
        "required": [
          "business_id",
          "url"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "delete_webhook",
      "description": "Delete a webhook endpoint.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "business_id": {
            "type": "string",
            "description": "The business ID."
          },
          "webhook_id": {
            "type": "string",
            "description": "The webhook ID."
          }
        },
        "required": [
          "business_id",
          "webhook_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    }
  ],
  "mcpServers": {
    "max": {
      "command": "npx",
      "args": [
        "-y",
        "sortlist-max-mcp"
      ],
      "env": {
        "MAX_API_KEY": "${MAX_API_KEY}"
      }
    }
  },
  "mediaType": "application/mcp-server-card+json"
}
