Represents a personal connector definition that enables integration with external services through MCP (Model Context Protocol). Personal connectors can be official (externally hosted), Aitronos-built (hosted by Aitronos), or custom (user-provided MCP servers).
id string
Unique identifier for the personal connector. Format: pcon_ followed by alphanumeric characters.
object string
Object type identifier. Always personal_connector.
name string
Human-readable name for the connector. Examples: "GitHub", "ClickUp", "Jira", "Microsoft Teams".
type string
Connector type. Values:
official- Externally hosted connector (e.g., GitHub, Figma)aitronos_built- Hosted and maintained by Aitronos (e.g., ClickUp, Jira, Teams)custom- User-provided MCP server
connector_id string
Unique identifier for the connector type. Examples: github, clickup, jira, teams, custom_mcp.
description string optional
Brief description of what the connector does and which service it integrates with.
iconUrl string optional
URL to the connector's icon image. Used for visual identification in UI.
category string optional
Connector category for organization. Values: productivity, development, communication, design, custom.
version string optional
Connector version. Format: semantic versioning (e.g., 1.0.0).
status string
Connector availability status. Values:
active- Connector is available for usedeprecated- Connector is deprecated, use alternativemaintenance- Temporarily unavailable for maintenance
server_url string optional
MCP server URL for official and custom connectors. Examples:
https://github-mcp.example.com(official)http://clickup-mcp:8000(aitronos_built)https://my-custom-server.com/mcp(custom)
serverType string optional
MCP server communication protocol. Values: http, websocket, stdio.
metadata object optional
Additional metadata about the connector. Key-value pairs for custom attributes.
created_at string
ISO 8601 timestamp when the connector was created.
updated_at string
ISO 8601 timestamp when the connector was last updated.
created_by string optional
User ID of the admin who added this connector (for custom connectors).