GET_USER_EDITED_WIKIS

Retrieve wikis edited by a specific user on IQ.wiki using their Ethereum address, with optional time frame filtering for precise results.

Instructions

Get wikis edited by a specific user on IQ.wiki

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	The Ethereum address of the user
`timeFrameSeconds`	No	Optional time frame in seconds to filter results

Implementation Reference

src/tools/get-user-edited-wikis.ts:18-31 (handler)

The execute function serving as the main handler for the GET_USER_EDITED_WIKIS tool. It instantiates the service, executes the query with parameters, formats the result, and handles errors.

execute: async (params: GetUserEditedWikisParams) => {
	try {
		const service = new GetUserEditedWikisService();
		const wikis = await service.execute(params.id, params.timeFrameSeconds);

		return service.format(wikis);
	} catch (error) {
		if (error instanceof Error) {
			console.log(`Error in GET_USER_EDITED_WIKIS tool: ${error.message}`);
			return `Error retrieving user edited wikis: ${error.message}`;
		}
		return "An unknown error occurred while fetching user edited wikis";
	}
},

src/tools/get-user-edited-wikis.ts:4-10 (schema)

Zod schema defining the input parameters for the tool: user ID (Ethereum address) and optional time frame.

const getUserEditedWikisParams = z.object({
	id: z.string().min(1).describe("The Ethereum address of the user"),
	timeFrameSeconds: z
		.number()
		.optional()
		.describe("Optional time frame in seconds to filter results"),
});

src/index.ts:17-21 (registration)

Registration of the getUserEditedWikisTool (line 19) along with other tools to the FastMCP server.

server.addTool(getWikiTool);
server.addTool(getUserCreatedWikisTool);
server.addTool(getUserEditedWikisTool);
server.addTool(getWikiActivitiesTool);
server.addTool(searchWikiTool);

src/services/get-user-edited-wikis.ts:7-58 (helper)

Core logic in GetUserEditedWikisService.execute: performs GraphQL query for user's edited wikis, filters for actual edits using metadata, handles time frame (with limitations), and returns filtered wikis.

async execute(id: string, timeFrameSeconds?: number) {
	try {
		const response: any = await client.request(USER_EDITED_WIKIS_QUERY, {
			id,
		});

		if (!response.userById) {
			throw new Error("user does not exist");
		}
		if (!response.userById.wikisEdited.activity) {
			throw new Error("user has not edited any wikis");
		}

		let wikis = response.userById.wikisEdited.activity[0].content;

		// Since the updated field is null for edited wikis, we need to detect edits by metadata
		// Filter out wikis that aren't actually edits (they should have previous_cid in metadata)
		wikis = wikis.filter((wiki: any) => {
			// Check for edit-specific metadata
			const hasMetadata = wiki.metadata && Array.isArray(wiki.metadata);
			if (!hasMetadata) return false;

			// Look for previous_cid which indicates this is an edit
			return wiki.metadata.some((meta: any) => meta.id === "previous_cid");
		});

		// Filter by time if timeFrameSeconds is provided
		// Since we don't have updated timestamps, we'll use timestamp from references if available
		if (timeFrameSeconds && wikis.length > 0) {
			const now = new Date();
			const timeLimit = new Date(now.getTime() - timeFrameSeconds * 1000);

			// We need to skip time filtering because we don't have reliable timestamps
			// Just inform the user that we can't filter by time
			if (wikis.length === 0) {
				// Convert seconds to a human-readable format for the error message
				const timeFrameText =
					timeFrameSeconds >= 86400
						? `${timeFrameSeconds / 86400} day(s)`
						: timeFrameSeconds >= 3600
							? `${timeFrameSeconds / 3600} hour(s)`
							: `${timeFrameSeconds / 60} minute(s)`;

				throw new Error(`No edited wikis found in the last ${timeFrameText}`);
			}
		}

		return wikis;
	} catch (error: any) {
		throw new Error(error.message);
	}
}

src/services/get-user-edited-wikis.ts:60-92 (helper)

Format method of the service that transforms the raw wiki data into a human-readable string with details on edits, timestamps, changes, and links.

	format(wikis: any) {
		return wikis
			.map((wiki: any) => {
				// Find edit-related metadata
				const wordsChanged =
					wiki.metadata.find((m: any) => m.id === "words-changed")?.value ||
					"Unknown";
				const percentChanged =
					wiki.metadata.find((m: any) => m.id === "percent-changed")?.value ||
					"Unknown";
				const blocksChanged =
					wiki.metadata.find((m: any) => m.id === "blocks-changed")?.value ||
					"Unknown";

				// Get the date from updated or fallback to a reasonable alternative
				const date = new Date(wiki.updated || wiki.created);
				const formattedDate = date.toLocaleString();

				return dedent`
						📜 Wiki Edited
						- Title: ${wiki.title}
						- Summary: ${wiki.summary}
						- Edited: ${formattedDate}
						- Changes: ${wordsChanged} words (${percentChanged}%)
						- Modified sections: ${blocksChanged}

						🔗 Source: ${IQ_REVISION_URL}/${wiki.ipfs}
						🔗 Transaction: https://polygonscan.com/tx/${wiki.transactionHash}
					`;
			})
			.join("\n\n");
	}
}

MCP-IQWiki