# Read source sentiment status Canonical URL: https://sosoapi.ai/docs/mcp/research-sentiment-status `sosoapi_research_sentiment_status` Read sentiment status and untrusted cited output for one conversation/run; never regenerates. Requires agent:research. ## Profiles and transports Profiles: full Transports: stdio, http Choose core or full to control which tools your client sees; this does not change its permissions. Local file upload requires stdio and is unavailable over HTTP. Set SOSOAPI_OUTPUT_SCHEMAS=1 to include output schemas in discovery. Tools return structured results with or without that setting. ## Permissions and side effects Annotations help clients describe a tool. Each call still checks the user’s authentication, role, resource access and capability grants. ```json { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } ``` `/research-api/sentiment/status` — agent:research; current authorized selected-source sentiment result with uncertainty ## Input fields ```json { "type": "object", "properties": { "workspace_id": { "type": "string", "format": "uuid" }, "conversation_id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" } }, "required": [ "workspace_id", "conversation_id", "run_id" ], "additionalProperties": false } ``` ## Structured output This schema describes structuredContent in a successful tool result. The MCP response also includes content and may set isError when a call fails. For publishing, read the post’s final result rather than treating an accepted request or text response as confirmation. The linked API operation explains permissions and retry rules. ```json { "type": "object", "properties": { "run": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "workspace_id": { "type": "string", "format": "uuid" }, "conversation_id": { "type": "string", "format": "uuid" }, "conversation_revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "generation": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "request_kind": { "type": "string", "enum": [ "question", "overview", "themes", "audiences", "sentiment", "query_suggestions" ] }, "status": { "type": "string", "enum": [ "queued", "processing", "completed", "failed", "cancelled", "expired", "unavailable" ] }, "failure_code": { "anyOf": [ { "type": "string", "enum": [ "not_configured", "budget_exhausted", "access_changed", "source_unavailable", "context_changed", "input_too_large", "provider_unavailable", "generation_unconfirmed", "invalid_output", "cancelled", "expired", "conversation_full" ] }, { "type": "null" } ] }, "created_at": { "type": "string", "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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "expires_at": { "type": "string", "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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "processor": { "type": "string", "const": "Google Gemini" }, "model_id": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] }, "model_version": { "anyOf": [ { "type": "string", "maxLength": 128 }, { "type": "null" } ] } }, "required": [ "id", "workspace_id", "conversation_id", "conversation_revision", "generation", "request_kind", "status", "failure_code", "created_at", "expires_at", "processor", "model_id", "model_version" ], "additionalProperties": false }, "message": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "run_id": { "type": "string", "format": "uuid" }, "role": { "type": "string", "enum": [ "user", "assistant" ] }, "question": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ] }, "answer": { "anyOf": [ { "type": "object", "properties": { "answer": { "type": "object", "properties": { "statement": { "type": "string", "minLength": 1, "maxLength": 2000 }, "basis": { "type": "string", "enum": [ "observed", "inferred", "generated" ] }, "evidence": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "evidence_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "evidence_id", "revision" ], "additionalProperties": false } }, "uncertainty": { "type": "string", "maxLength": 1000 } }, "required": [ "statement", "basis", "evidence", "uncertainty" ], "additionalProperties": false }, "findings": { "maxItems": 12, "type": "array", "items": { "type": "object", "properties": { "statement": { "type": "string", "minLength": 1, "maxLength": 2000 }, "basis": { "type": "string", "enum": [ "observed", "inferred", "generated" ] }, "evidence": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "evidence_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "evidence_id", "revision" ], "additionalProperties": false } }, "uncertainty": { "type": "string", "maxLength": 1000 } }, "required": [ "statement", "basis", "evidence", "uncertainty" ], "additionalProperties": false } }, "sentiment": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "evidence_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "label": { "type": "string", "enum": [ "positive", "negative", "neutral", "mixed", "unknown" ] }, "uncertainty": { "type": "string", "maxLength": 1000 } }, "required": [ "evidence_id", "revision", "label", "uncertainty" ], "additionalProperties": false } }, "query_suggestions": { "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 2000 }, "excluded_terms": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "evidence": { "minItems": 1, "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "evidence_id": { "type": "string", "format": "uuid" }, "revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "evidence_id", "revision" ], "additionalProperties": false } }, "rationale": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "query", "excluded_terms", "evidence", "rationale" ], "additionalProperties": false } }, "limitations": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "quantitative_claims": { "type": "boolean", "const": false }, "method_version": { "type": "string", "const": "research-cited/v1" } }, "required": [ "answer", "findings", "sentiment", "query_suggestions", "limitations", "quantitative_claims", "method_version" ], "additionalProperties": false }, { "type": "null" } ] }, "created_at": { "type": "string", "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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "expires_at": { "type": "string", "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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" } }, "required": [ "id", "run_id", "role", "question", "answer", "created_at", "expires_at" ], "additionalProperties": false }, { "type": "null" } ] }, "conversation_revision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "availability": { "type": "object", "properties": { "configured": { "type": "boolean" }, "reason": { "anyOf": [ { "type": "string", "enum": [ "not_configured", "budget_exhausted", "access_changed", "source_unavailable", "context_changed", "input_too_large", "provider_unavailable", "generation_unconfirmed", "invalid_output", "cancelled", "expired", "conversation_full" ] }, { "type": "null" } ] }, "processor": { "type": "string", "const": "Google Gemini" }, "retention_hours": { "type": "number", "const": 24 } }, "required": [ "configured", "reason", "processor", "retention_hours" ], "additionalProperties": false } }, "required": [ "run", "message", "conversation_revision", "availability" ], "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false } ``` ## Example tool call These examples use fictional values checked against the schemas. Replace the IDs with ones you are authorized to use, the media with ready assets and the dates with your confirmed publishing time. Check the account’s eligibility before submitting a write. This page sends no API requests. ```json { "name": "sosoapi_research_sentiment_status", "arguments": { "workspace_id": "11111111-1111-4111-8111-111111111111", "conversation_id": "11111111-1111-4111-8111-111111111111", "run_id": "11111111-1111-4111-8111-111111111111" } } ``` structuredContent ```json { "run": { "id": "11111111-1111-4111-8111-111111111111", "workspace_id": "11111111-1111-4111-8111-111111111111", "conversation_id": "11111111-1111-4111-8111-111111111111", "conversation_revision": 1, "generation": 1, "request_kind": "question", "status": "queued", "failure_code": null, "created_at": "2099-01-15T09:00:00Z", "expires_at": "2099-01-15T09:00:00Z", "processor": "Google Gemini", "model_id": null, "model_version": null }, "message": null, "conversation_revision": 1, "availability": { "configured": false, "reason": null, "processor": "Google Gemini", "retention_hours": 24 } } ``` ## Underlying API operations - [/research-api/sentiment/status](https://sosoapi.ai/docs/api/research-api-sentiment-status)