GET_WIKI
Retrieve detailed information about a specific wiki from IQ.wiki by providing its unique ID.
Instructions
Get details about a specific wiki from IQ.wiki by ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the wiki to retrieve |
Implementation Reference
- src/tools/get-wiki.ts:10-28 (handler)The tool handler that defines the GET_WIKI tool with name, description, Zod schema, and execute function. It creates a GetWikiService, calls execute with the wiki ID, and formats the result.
export const getWikiTool = { name: "GET_WIKI", description: "Get details about a specific wiki from IQ.wiki by ID", parameters: getWikiParams, execute: async (params: GetWikiParams) => { try { const service = new GetWikiService(); const wiki = await service.execute(params.id); return service.format(wiki); } catch (error) { if (error instanceof Error) { console.log(`Error in GET_WIKI tool: ${error.message}`); return `Error retrieving wiki: ${error.message}`; } return "An unknown error occurred while fetching wiki data"; } }, } as const; - src/tools/get-wiki.ts:4-6 (schema)Zod schema defining the input parameter for the GET_WIKI tool: a required non-empty string 'id'.
const getWikiParams = z.object({ id: z.string().min(1).describe("The ID of the wiki to retrieve"), }); - src/index.ts:17-17 (registration)Registration of the GET_WIKI tool with the FastMCP server instance.
server.addTool(getWikiTool); - src/services/get-wiki.ts:6-33 (helper)Service class that executes the GraphQL query to fetch wiki data by ID and formats the response with title, summary, source URL, and transaction link.
export class GetWikiService { async execute(id: string) { try { const response = await client.request(WIKI_QUERY, { id, }); if (!response.wiki) { throw new Error("Wiki Not found"); } return response.wiki; } catch (error: any) { throw new Error(error.message); } } format(wiki: any) { const formattedWiki = dedent` 📜 Wiki Details - Title: ${wiki.title} - Summary: ${wiki.summary} 🔗 Source: ${IQ_BASE_URL}/${wiki.id} 🔗 Transaction: https://polygonscan.com/tx/${wiki.transactionHash} `; return formattedWiki; } }