Noun Project MCP Server

Instructions

Implementation Reference

• src/api.ts:90-104 (handler)

  Core handler function that fetches detailed information about a specific icon by ID from the Noun Project API, handling thumbnail size parameter and OAuth headers.

  async getIcon(params: GetIconParams) {
    const { icon_id, thumbnail_size } = params;
    const queryParams = thumbnail_size
      ? `?thumbnail_size=${thumbnail_size}`
      : '';
    const url = `${BASE_URL}/v2/icon/${icon_id}${queryParams}`;
    const headers = this.oauth.getHeaders(url);
  
    const response = await this.client.get(`/v2/icon/${icon_id}`, {
      params: thumbnail_size ? { thumbnail_size } : undefined,
      headers,
    });
  
    return response.data;
  }

• src/index.ts:66-76 (handler)

  MCP server tool dispatch handler for 'get_icon', calling the API method and formatting the response as MCP content.

  case 'get_icon': {
    const result = await api.getIcon(args as any);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/tools.ts:49-68 (registration)

  Tool registration in the TOOLS array, including name, description, and input schema for MCP listTools response.

  {
    name: 'get_icon',
    description:
      'Get detailed information about a specific icon by its ID. Returns icon metadata, creator info, tags, and download URLs.',
    inputSchema: {
      type: 'object',
      properties: {
        icon_id: {
          type: 'number',
          description: 'The unique ID of the icon',
        },
        thumbnail_size: {
          type: 'number',
          enum: [42, 84, 200],
          description: 'Thumbnail size to return (42, 84, or 200 pixels)',
        },
      },
      required: ['icon_id'],
    },
  },

• src/api.ts:18-21 (schema)

  TypeScript interface defining input parameters for the getIcon API method.

  export interface GetIconParams {
    icon_id: number;
    thumbnail_size?: 42 | 84 | 200;
  }