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.
icon_url 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)
server_type 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).