Get research subjects
get_subjectsRetrieves matching released research subjects by name or kind, including companies, industries and investment themes. Returns matching subject identifiers and available research coverage. Useful for resolving a non-company topic before requesting a brief or cases. Use the returned entity_id for follow-up research and preserve ambiguity when multiple subjects match; a ticker is optional for non-company subjects. Uses account allowance or prepaid credit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "get_subjects"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| kind | No | ||
| as_of | No | ||
| limit | No | Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the same ticker/entity_id. REST supports larger pages. | |
| cursor | No | ||
| context | Yes | User's research goal in one short sentence (max 300 characters); include relevant ticker and topic. Exclude names, contact/account/portfolio details, credentials and source text. | |
| llm_model | Yes | Your model identifier, if known (e.g. gpt-6); otherwise leave unknown. Exclude credentials and private deployment names. | |
| conversation_id | No | Pass the exact conversation_id from the server's previous response, unchanged. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it. Keep passing the same conversation_id for the rest of the conversation, including after later user messages or on a different task; do not reset it when the user starts a new request. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||