get-tag
Retrieve a specific tag by ID using client and ID parameters in the MCP-N8N server. Simplify data access and management with this targeted query tool.
Instructions
Retrieve a specific tag by ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clientId | Yes | ||
| id | Yes |
Implementation Reference
- src/index.ts:1758-1788 (handler)Primary MCP tool handler for 'get-tag'. Retrieves the N8nClient by clientId, calls getTag(id), formats response as JSON or error.
case "get-tag": { const { clientId, id } = args as { clientId: string; id: string }; const client = clients.get(clientId); if (!client) { return { content: [{ type: "text", text: "Client not initialized. Please run init-n8n first.", }], isError: true }; } try { const tag = await client.getTag(id); return { content: [{ type: "text", text: JSON.stringify(tag, null, 2), }] }; } catch (error) { return { content: [{ type: "text", text: error instanceof Error ? error.message : "Unknown error occurred", }], isError: true }; } } - src/index.ts:313-315 (helper)N8nClient helper method implementing the core logic: API GET request to /tags/{id}.
async getTag(id: string): Promise<N8nTag> { return this.makeRequest<N8nTag>(`/tags/${id}`); } - src/index.ts:759-769 (registration)Tool registration entry in ListTools response, defining name, description, and input schema.
name: "get-tag", description: "Retrieve a specific tag by ID.", inputSchema: { type: "object", properties: { clientId: { type: "string" }, id: { type: "string" } }, required: ["clientId", "id"] } }, - src/index.ts:79-84 (schema)TypeScript interface defining the structure of a N8nTag object used in getTag response.
interface N8nTag { id: string; name: string; createdAt?: string; updatedAt?: string; }