Tálamo MCPv1.3
journal_create_or_update
Prepares a journal create or update and requires approval in Tálamo.
Journal
May modify a record
Contract version 1.0.0
Permissions and security
- Data source
- journal
- Requires confirmation
- Yes
- openWorld
- false
Input schema
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
},
"instrument": {
"type": "string",
"minLength": 2,
"maxLength": 24
},
"direction": {
"type": "string",
"enum": [
"BUY",
"SELL"
]
},
"entry_price": {
"type": "number",
"exclusiveMinimum": 0
},
"lot_size": {
"type": "number",
"exclusiveMinimum": 0
},
"status": {
"default": "open",
"type": "string",
"enum": [
"planned",
"open",
"closed",
"cancelled"
]
},
"trade_date": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"exit_price": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"result": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"notes": {
"type": "string",
"maxLength": 1000
},
"confirmation_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
}
},
"required": [
"instrument",
"direction",
"entry_price",
"lot_size",
"status",
"trade_date"
],
"additionalProperties": false
}Output schema
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"confirmation_required": {
"type": "boolean"
},
"confirmation_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
},
"confirmation_url": {
"type": "string",
"format": "uri"
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
}
},
"additionalProperties": {}
}Example
json
{
"title": "Prepare a planned trade",
"input": {
"instrument": "XAUUSD",
"direction": "BUY",
"entry_price": 4300,
"lot_size": 0.1,
"status": "planned",
"trade_date": "2026-08-06T12:00:00.000Z"
},
"output": {
"confirmation_required": true,
"confirmation_id": "00000000-0000-4000-8000-000000000001",
"confirmation_url": "https://talamo.app/mcp/confirm/00000000-0000-4000-8000-000000000001",
"expires_at": "2026-08-06T12:10:00.000Z"
}
}Limits
- One-time confirmation expires after 10 minutes.
- An update can only target an entry owned by the authenticated user.
Stable errors
| Code | Description |
|---|---|
UNAUTHORIZED | The OAuth token is missing, expired, revoked, or invalid for this resource. |
VALIDATION_ERROR | The arguments do not match the published input schema. |
TOOL_ERROR | The operation could not be completed without exposing internal details. |
CONFIRMATION_REQUIRED | Open the returned URL and approve the exact action. |
CONFIRMATION_INVALID | The approval is expired, denied, already used, or does not match the payload. |