add_context
Add a new context item to your reference library. Context items are reference materials that power AI generation — they help the AI produce more accurate, on-brand, and relevant content.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Descriptive name for the context item |
content | string | Yes | — | The reference content to store |
collection_id | integer | No | — | Collection ID from get_context_collections |
project_id | string (uuid) | No | — | Project ID to associate with |
Input Schema
{
"type": "object",
"required": [
"name",
"content"
],
"properties": {
"name": {
"type": "string",
"description": "Descriptive name for the context item"
},
"content": {
"type": "string",
"description": "The reference content to store"
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project ID to associate with (from get_projects)"
},
"collection_id": {
"type": "integer",
"description": "Collection ID to organize the item (from get_context_collections or create_context_collection)"
}
}
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Context item ID"
},
"name": {
"type": "string",
"description": "Context item name"
},
"content": {
"type": "string",
"description": "The stored reference content"
},
"link_url": {
"type": "string",
"format": "uri",
"description": "Direct URL to view this context item in the MarketCore app. Resolves to the project, collection, or reference library view depending on the item's scope."
},
"created_at": {
"type": "integer",
"description": "Unix timestamp of creation"
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project association (if assigned)"
},
"word_count": {
"type": "integer",
"description": "Word count of content"
},
"collection_id": {
"type": "integer",
"description": "Collection this item belongs to (if assigned)"
}
}
}Instructions
Use this tool to add a new context item to your reference library.
Workflow:
- Provide a descriptive
name. - Provide the
content(brand guidelines, company info, product details, personas, research, etc.). - Optionally assign to a collection by passing
collection_id. Uselist_context_collectionsto see existing collections and their IDs, or usecreate_context_collectionto create a new one and get its ID. - Optionally associate with a project by passing
project_id. Uselist_projectsto see available projects and their IDs.
Use context items for: brand voice guidelines, company facts, product descriptions, audience personas, competitive intelligence.
Examples
Add competitor research to a project
Store competitor analysis as context tied to a specific project, so content generated for that project can reference competitive positioning.
Input
{
"name": "Q2 Competitor Analysis — Acme Corp",
"content": "Acme Corp launched a freemium tier in March. Their messaging focuses on speed and simplicity. Key weakness: no enterprise SSO support.",
"project_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}Output
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"name": "Q2 Competitor Analysis — Acme Corp",
"content": "Acme Corp launched a freemium tier in March...",
"word_count": 27,
"project_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"created_at": 1712678400
}