get contents
Retrieve content from TabNews API using pagination and sorting strategies to access articles, posts, or discussions.
Instructions
get contents from tabnews api
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get contents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | The page number to get | |
| per_page | No | The number of contents per page | |
| strategy | No | The strategy to get the contents |
Implementation Reference
- src/index.ts:31-36 (registration)Registration of the "get contents" tool on the MCP server by calling server.tool() with the tool's properties.
server.tool( getContentsTool.name, getContentsTool.description, getContentsTool.parameters, getContentsTool.handler ); - src/tools/status.ts:58-81 (handler)The handler function that executes the "get contents" tool logic: fetches data using getContents API helper, formats as JSON text response, handles errors.
handler: async (params: GetContentsParams): Promise<McpResponse> => { try { const result = await getContents({ page: params.page, per_page: params.per_page, strategy: params.strategy, }); const content: McpTextContent = { type: "text", text: `Contents:\n\n${JSON.stringify(result, null, 2)}`, }; return { content: [content], }; } catch (error) { if (error instanceof Error) { throw new Error(`Failed to get contents: ${error.message}`); } else { throw new Error("Failed to get contents"); } } }, - src/tools/status.ts:50-57 (schema)Zod schema defining input parameters for the "get contents" tool: page, per_page, strategy.
parameters: { page: z.number().optional().describe("The page number to get"), per_page: z.number().optional().describe("The number of contents per page"), strategy: z .enum(["relevant", "new", "old"]) .optional() .describe("The strategy to get the contents"), }, - src/services/api.ts:22-37 (helper)Helper function getContents that performs the actual API fetch to TabNews /contents endpoint, used by the tool handler.
export async function getContents({ page = 1, per_page = 30, strategy = "relevant", }: GetContentsParams = {}): Promise<TabNewsContent[]> { const queryParams = new URLSearchParams({ page: page.toString(), per_page: per_page.toString(), strategy: strategy, }); const response = await fetch(`${TABNEWS_API_URL}/contents?${queryParams}`); const data = await response.json(); return data as TabNewsContent[]; }