Purpose

This is the machine-readable contract that agents code against when interacting with the Tentacles Ticket System via the Notion MCP or API. For the higher-level rules and conventions, see the Agent Database Creation Convention.

Note: All database IDs, data source IDs, and project codes shown as {PLACEHOLDER} values are populated during onboarding. The agent config JSON file contains your real values.

Database References

Resource ID
Tickets database {TICKETS_DB_ID}
Tickets data source {TICKETS_DS_ID}
Active Engagements data source {ENGAGEMENTS_DS_ID}
Tasks data source {TASKS_DS_ID}
Initiatives data source {INITIATIVES_DS_ID}
Internal Projects data source {PROJECTS_DS_ID}
Client Database data source {CLIENTS_DS_ID}
Notion MCP URL https://mcp.notion.com/mcp

Ticket Creation

Required Fields

Property Type Notes
Title title Short description of the request
Project Code select Must be an exact match from the master list
Description rich_text Detailed description
Priority select One of: P0, P1, P2, P3

Agent-Required Fields

Property Value
Source Must be set to "Agent"
Requester Agent name or ID (e.g., "tentacles-agent")

Exact Enum Values

Agents must use these exact strings. Any deviation will fail silently or error.

Tickets

Tasks